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PREFACE 


This manual describes the assembly language for the TA 1630 Computer, as im- 
plemented by SDSMAC, a two-pass assembler that executes under Disk Executive 
TAXO. , 

The sections and appendixes of this manual are organized as follows: 

Section 


1. Introduction - Provides a general definition of assembly language 
and then discusses the assembly language programming process. 


2 General Programming Information - Provides general information on 
the TA 1630 hardware, on constants and variables, and on the source 
statement format. 


3 Assembly Instructions - Describes the addressing modes of the TA 1630 
computer, and defines each of the assembly language instructions. 
Programming examples are provided. 


4 Assembler Directives - Describes the directives that control the 
assembly process. 


5  Pseudo-instructions - Defines the three assembly pseudo-instructions. 


6 Assembler - Provides information on the assembler, and lists assembler 
directives for the SDSMAC assembler. 


7 Macro Language - Describes the macro language available with the 
SDSMAC assembler, and defines the verbs used by the macro language. 


8 Relocatability and Program Linking - Describes the relocation capa- 
bility of assembly language programs. Describes how program modules 
are linked with shared symbols across the modules. 


9 Operation of the Macro Assembler - Describes the commands used to 
execute the SDSMAC assembler in foreground and batch modes, 


10 Assembler Output - Lists the error messages and object code formats 
produced by the assembler, 


Appendix 


A 
B 


Character Set - Lists the characters recognized by the assembler. 


Instruction Tables - List of the assembler instructions showing syntax, 
results, and status information, 


Program Organization - Describes recommended program structure. 


Hexadecimal Instruction Table - Lists the instructions by order of 
hexadecimal opcode. 


Alphabetical Instruction Table - Lists the instructions in alphabe- 
tical order. 


Assembler Directive Table - Lists the assembler directives and gives 
the syntax. 


Macro Language Table - Lists the macro verbs and gives the syntax. 


CRU Interface Example - Gives a programming example used for a CRU 
device. 


TILINE Interface Example - Gives a programming example used for a 
TILINE device. 


Example Program - Gives a general assembly language programming example. 


Numerical Tables - Give commonly referenced numeric terms and decimal- 
hexadecimal conversion charts. 


This manual assumes that the reader is familiar with the TA 1630 computer 
architecture and I/O capabilities. 
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SECTION 1 


INTRODUCTION 


Assembly Language Definition 


An assembly language is a computer-oriented language for writing programs. 
It consists of mnemonic instructions and assembler directives. In assembly 
instructions, the user assigns symbolic addresses to memory locations and 
specifies instructions by means of symbolic operation codes called mnemo- 
nic operation codes. The user specifies instruction operands by means of 
symbolic addresses, numbers, and expressions consisting of symbolic ad- 
dresses and numbers. Assembler directives control the process of making 

a machine language program from the assembly language program, place data 
in the program, and assign symbols to values to be used in the program. 
Assembler directives that place data in memory locations allow the user 
to assign symbolic addresses to those locations. 


An assembly language is computer-oriented in that the mnemonic operation 
codes correspond directly with machine instructions. The chief advantage 
an assembly language offers over machine language is that the symbols of 
assembly language are easier to use and easier to remember than the zeros 
and ones of machine language. Other advantages are the use of expressions 
as operands and the use of decimal numbers in expressions and as operands. 


Assembly Language Application 


An assembly language program, called a source program, must be processed 
by an assembler to obtain a machine language program that can be executed 
by the computer. Processing of a source program is called assembling, 
because it consists of assembling the binary values that correspond to 
the mnemonic operation code with the binary address information to form 
the machine language instruction. 


To illustrate the place of assembly language in the development of pro- 
grams, consider the following steps in program development: 


1 
2 


Define the problem, 


Flowchart the solution to the problem. 


3. Code the solution by writing assembly language statements (machine in- 
structions and assembler directives) that correspond to the steps of 
the flowchart. 


4, Prepare the source program by writing the statements on the medium 
appropriate to the installation; i.e., textedit the statements if a 
disk file is to be used as input to the assembler etc. 


5, Execute the assembler to assemble the machine language object code 
corresponding to the source program. 


6. Debug the resulting object code by loading and executing the object 
code and by making correction indicated by the results of executing 
the object code. 


7. Repeat steps 5 and 6 until no further correction is required. 


The use of assembly language in program development relieves the program- 
mer of the tedious task of writing machine language instruction and keep- 
ing track of binary machine addresses within the program. 
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SECTION 2 


GENERAL PROGRAMMING INFORMATION 


Byte Organization 


Memory for the TA 1630 Computer is addressed using byte addresses, A 
byte consists of eight bits of memory, as shown in figure 2-1, The bits 
may represent the states of eight independent two-valued quantities, or 
the configuration of a character in a code used for input, output, or 
data transmission. The bits also may represent a number which is inter- 
preted either as a signed number in the range of -128 through +127 or 

as an unsigned number in the range of O through 255, The TA 1630 Computer 
implements signed numbers in 2's complement form, 


The most significant bit (MSB) is designated bit 0, and the least signi- 
ficant bit (LSB) is designated bit 7, A byte instruction may address any 
byte in memory. 


2.2 Word Organization 


A word in the memory for the TA 1630 Computer consists of 16 bits, a byte 
at an even address and the following byte at an odd address. As shown in 
figure 2-2, the most significant bit of a memory word is designated bit 0, 
and the least significant bit is designated bit 15, A word may contain a 
computer instruction in machine language, a memory address, the bit con- 
figurations of two characters, or a number. When a word contains a number, 
the number may be interpreted as a signed number in the range of -32,768 
through +32,767, or as an unsigned number in the range of O through 65,535, 
(Signed numbers are implemented in 2's complement form. ) 


Word boundaries are assigned to even-numbered addresses in memory, The 
even address byte contains bits 0 through 7 of the word, and the odd ad- 
dress byte contains bits 8 through 15. When word instructions address an 
odd byte, the word operand is the memory word consisting of the addressed 
byte and the preceding even-numbered byte, This is the memory word that 
would be accessed by the odd address minus one. For example, a memory ad- 
dress of 102316 used as a word address would access the same word as me- 
mory address 10221¢. 


NOTE 
All instructions must begin on word boundaries. Instructions are 
1, 2, or 3 words long. 


(MSB) (LSB) 


Figure 2-1. Memory Byte 


(MSB) (LSB) 
of @ BB 42°S 6 F ‘8 9 10 1% 12°13 14 15 
(WORD BOUNDARY) 


Figure 2-2, Memory Word 
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Transfer Vectors 


A transfer vector is a pair of memory addresses in two consecutive 

words of memory. The first word contains the address of a 16-word area 
of memory, called a workspace. The second word contains the address of 

a subroutine entry point. The TA 1630 Computer uses a transfer vector 

in a type of transfer of control called a context switch. A context 
switch places the contents of the first word of a transfer vector in the 
Workspace Pointer (WP) register, making the workspace addressed by that 
word the active workspace. The 16 words of the active workspace become 
workspace registers 0 through 15, which are available for use as general 
purpose registers, address registers, or index registers. A context 
switch places the contents of the second word of a transfer vector in 
the Program Counter (PC), causing the instruction at that address to be 
executed next, 


A context switch transfers control to an interrupt subroutine whenever 

an interrupt occurs. The transfer vectors for interrupt levels O through 
15 are located in memory locations 000016 through 003E1¢, as shown in fi- 
gure 2-3, The address of the first byte of the vector for an interrupt 
level is the product of the level number times four. 


The TA 1630 Computer supports extended operations implemented by sub- 
routines, These extended operations are effectively additional instruc- 
tions that may perform user-defined functions, Up to 16 extended opera- 
tions may be implemented. An extended operation machine instruction re- 
sults in a context switch to the specified extended operation subroutine. 
The transfer vectors for extended operations O through 15 are located in 
memory locations 004016 through 007E1¢ as shown in figure 2-3, The address 
of the first byte of the vector for an extended operation is the hexadeci- 
mal sum of the product of the extended operation number times four, plus 


4016. 


In the TA 1630 Computer, an extended operation may be implemented with 
user-supplied hardware. When a hardware module is connected for an ex- 
tended operation, no context switch occurs for that operation, and the 
hardware performs the operation, Program execution continues when the ope- 
ration has completed. 


A context switch using the transfer vector at memory location FFFC)¢ trans- 
fers control to a subroutine to load or restart the computer, Execution 

of an LREX instruction or activation of a switch on the control panel ini- 
tiates the context switch. 


A context switch to a user subroutine is performed by the BLWP instruc- 
tion. The transfer vector is placed at a user defined location in memory. 


Status Register 


The configuration of the Status Register of the TA 1630 Computer is shown 
in figure 2-4, Bits 0 through 6 and 12 through 15 are the bits that are 
reset by the machine instructions. These bits have the following meanings: 


e L>, bit 0 - Logical greater than 

e A>, bit 1 - Arithmetic greater than 
e £Q, bit 2 - Equal 

e C, bit 3 - Carry 
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Figure 2-3, Typical Memory Map for the TA 1630 
e OV, bit 4 - Overflow 

e OP, bit 5 - Odd parity 

e X, bit 6 - Extended operation 

e Bits 12-15 - Interrupt mask 


The remaining two bits are explained in the following. Bit 7, the PR bit, 
is set to one to inhibit execution of the privileged instructions. When 
execution of a privileged instruction is attempted with the PR bit set to 
one, an illegal instruction error occurs, Bit 7 must be set to zero to 
execute these instructions. An additional bit, bit 8, the Map File (MF) 
bit specifies the memory map file for the memory mapping. The memory map- 
ping provides access to memory addresses outside of the range of addresses 
(32K words) of the address portions of instructions. When bit 8 is set to 
O, the six mapping registers for map O are active, When bit 8 is set to 1, 
the six mapping registers for map 1 are active, 
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Figure 2-4, Status Register of the TA 1630 


Logical Greater Than 


The logical greater than bit of the Status Register contains the result 
of a comparison of words or bytes as unsigned binary numbers. In this 

comparison, the most significant bits of words being compared represent 
2'%, and the most significant bits of bytes being compared represent y. 


Arithmetic Greater Than 


The arithmetic greater than bit of the Status Register contains the re- 
sult of a comparison of words or bytes as two's complement numbers, In 
this comparison, the most significant bits of words or bytes being com- 
pared represent the sign of the number, zero for positive, or one for 
negative. For positive numbers, the remaining bits represent the binary 
value. For negative numbers, the remaining bits represent the two's com- 
plement of the binary valve. 


Equal 


The equal bit of the Status Register is set when the words or bytes being 
compared are equal, Whether the comparison is that of unsigned binary 
numbers or two's complement numbers the significance of equality is the 
same, 


Carry 


The carry bit of the Status Register is set by a carry out of the most 
significant bit of a word or byte (sign bit) during arithmetic operations. 
The carry bit is used by the shift operations to store the last bit 
shifted out of the workspace register being shifted. 


Overflow 


The overflow bit of the Status Register is set when the result of an arith- 
metic operation is too large or too small to be correctly represented in 
two's complement representation. In addition operations, the overflow bit 
is set when the most significant bits of the operands are equal and the 
most significant bit of the result is not equal to the most significant 
bit of the destination operand, In subtraction operations, the overflow 
bit is set when the most significant bits of the operands are not equal, 
and the most significant bit of the result is not equal to the most signi- 
ficant bit of the destination operand. For a divide operation, the over- 
flow bit is set when the most significant sixteen bits of the dividend are 
greater than or equal to the divisor, For an arithmetic left shift, the 
overflow bit is set if the most significant bit of the workspace register 
being shifted changes value. For the absolute value and negate instruc- 
tions, the overflow bit is set when the source operand is the maximum ne- 
gative value, 80001¢. 
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Odd Parity 


The odd parity bit of the Status Register is set in byte operations when 
the parity of the result is odd, and is reset when the parity is even, 
The parity of a byte is odd when the number of bits having values of one 
is odd; when the number of bits having values of one is even, the parity 
of the byte is even, The odd parity bit is equal to the least significant 
bit of the sum of the bits in the byte. 


Extended Operation 


The extended operation bit of the Status Register is set to one when a 
software implemented extended operation is initiated. An extended ope- 
ration is initiated by a context switch using the transfer vector for 
the specified extended operation, After the WP and PC have been set to 
the values in the transfer vector, the extended operation bit is set. 


Status Bit Summary 


Table 2-1 lists the instructions of the TA 1630 Computer instruction set 
and the status bits affected by each instruction, The interrupt mask is 
explained in a subsequent paragraph, 


Memory Organization 


Figure 2-3 shows a generalized memory map applicable to the TA 1630 Com- 
puter memory. The area of low-order memory from address 0 through 7Fy¢ 
is used for interrupt and extended operation transfer vectors as pre- 
viously described, Addresses reserved for transfer vectors that are not 
used may be used for instructions and/or data, Since many memory confi- 
gurations are available, the programmer should ascertain the memory con- 
figuration for his system. 


The area of memory from address 80)¢ through address F7FE,, is available 
for workspaces, instructions, and data. Many users of TA 1830 Computers 
will place an executive (TAXO) in a portion of this area. The remainder 
of this area (as supplied) is available for workspaces, instructions, and 
data for user programs. TA 1630 Computer users who do not use TAXO may 
use the entire area (as supplied). 


Various types and sizes of memory are available for the TA 1630 Computer. 
Addressing is not necessarily continuous. Addresses may be assigned accor- 
ding to the needs of an application, omitting addresses as appropriate, 


In the TA 1630 Computer, addresses F800j¢ through FBFE;¢ are reserved 

for TILINE communication with peripheral devices. These addresses may be 
assigned to registers in controllers for direct memory access devices. 
Input/Output from or to these devices is performed using any instruction 
that may be used to access memory. For 1/0, the address in the instruction 
must be the TILINE address assigned to the appropriate register, An ex- 
ample of TILINE interface is shown in Appendix I, 
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Table 2-1. Status Bits Affected by Instructions (Continued) 
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MOV Bt Bok fede | we le STCR i Re. BS ee ee es 

MOVB eR UE ecw | Ee STST A > i'w Fe Rye hive Sia. rae 

MPY eo ee STWP ee ae ee ee eee 

NEG a an ee oe: or SWPB ye. a a ee te eS Cal om 

ORI i ae ee ee eee SZC X 7 £5 &% Fer fs 

RSET Sa a ee or a SZCB X ee eee 

RTWP : &£ x KX HR KB & TB ae ee eee ee Oe 

S xx kK EF Rk = = X 2 te 2 2 

SB ry & © *€ & & « XOP os -# +3 

SBO wom owe (me om we ee a. 2S ee ae 


Notes: 1. When an LDCR or STCR instruction transfers eight bits or less, the OP bit is set or reset as in 
byte instructions, Otherwise these instructions do not affect the OP bit. 


2. The X instruction does not affect any status bit; the instruction executed by the X instruction 
sets status bits normally for that instruction. When an XOP instruction is implemented by software, 
the XOP bit is set, and the subroutine sets status bits normally. 


L/2% 
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In the TA 1630 Computers, addresses FCO0¢ through FFFBy¢ are reserved for 
the Programmed Read Only Memory (PROM) which contains the programmer pa- 
nel program and a loader program. When the programmer panel is not con- 
nected, the program transfers control to the loader program. Control 
passes to the programmer panel program by a context switch using the 
transfer vector at address FFFC¢. 


Any 16-word area of memory may be assigned as a workspace, and becomes 

the active workspace when the address of the first word of the area is 

placed in the WP register. Figure 2-5 shows a workspace, with those re- 
gisters that have assigned functions identified in the figure. 


Memory for the TA 1630 Computer may contain more than 32K words, but 

the address format addresses only 32K words directly. The mapping is 
used to address memory locations outside of the 32K word addressing ca- 
pability, The mapping hardware has three 11-bit limit registers and three 
16-bit bias registers for each of the three map files. The mapped ad- 
dress is a 20-bit address, the sum of the 16-bit processor address and 
the contents of a bias register extended to the right with five zeros. 
The least significant bit (which selects bytes) is ignored. The limit 
registers contain the one's complement of the limits, and determine 
which bias register is used. When the 11 most significant bits of the 
16-bit address are less than or equal to limit 1, bias register 1 is 
used, When the same value is greater than limit 1 and less than or equal 
to limit 2, bias register 2 is used. When the same value is greater than 
limit 2 and less than or equal to limit 3, bias register 3 is used, When 
the same value is greater than limit 3, a mapping error interrupt occurs 
and memory is not accessed, 


MEMORY 
WP REGISTER (HEXADECIMAL) 


(A)132201 


Figure 2-5, TA 1630 Computer Workspace 
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Syntax definition: 
[<label>]b...RTWPb... [comment >] 
Example: 
LABEL RTWP RETURN FROM SUBROUTINE CALLED BY BLWP 


Definition: 

Replace the contents of the WP register with the contents of the current 
workspace register 13. Replace the contents of the PC with the contents 
of the current workspace register 14. Replace the contents of the ST 
register with the contents of the current workspace register 15. The 
effect of this instruction is to restore the execution environment 

that existed prior to an interrupt, a BLWP instruction, or an XOP in- 
struction. 


In the TA 1630 Computer with the Privileged Mode bit (bit 7) of the 
ST register set to 1, only bits 0 through 5 of workspace register 15 
are placed in bits 0 through 5 of the ST register. When bit 7 of the 
ST register is set to 0, the instruction places bits 0-8 and 12-15 of 
workspace register 15 into bits 0-8 and 12-15 of the ST register. 


Status bits affected: 
Restores all status bits to the value contained in workspace register 15. 


0 Agh2 S04 (SoG Hs SGegatopas v2 1994745 

i / / 
L>lA y/ INTERRUPT 
AA 


Execution results: (Workspace register 13) ~ (WP) 
(Workspace register 14) — (PC) 
(Workspace register 15) — (ST) 


Application notes: 

Use the RTWP instruction to restore the execution environment after 
the completion of execution of an interrupt, a BLWP instruction, or 
an XOP instruction. Refer to a subsequent paragraph for additional 
information. 


3.28 Unconditional Jump  JMP 
Op Code: 1000 


Addressing mode: Format II 


Format: 


i) 1 2 son £. SS 36 FZ 6 9 10 11471213 1415 
foo] sfofefo fe] cisruscewerr 
Syntax definition: 


[<label>]6...JMPb...<exp>b... [ccomment >] 


Example: 
LABEL JMP NXTLBL JUMP TO NXTLBL 
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Branch And Load Workspace Pointer _ BLWP 
Op Code: 0400 
Addressing mode: Format VI 


Format: 


9 10 11,12 13 14 15 


Syntax definition: 
[Klabel>]b...BLWPb...<ga.>b... [xcomment >] 
Example: 


LABEL BLWP (a@)VECT BRANCH TO SUBROUTINE AT ADDRESS 
( @)VECT+2) AND EXECUTE CONTEXT SWITCH 


Definition: 

Place the source operand in the WP and the word immediately following 
the source operand in the PC. Place the previous contents of the WP 
in the new workspace register 13, place the previous contents of the 
PC (address of the instruction following BLWP) in the new workspace 
register 14, and place the contents of the ST register in the new 
workspace register 15, When all store operations are complete, the 

AU transfers control to the new PC. 


Status bits affected: None 


7 10 11 12 13 14 15 


Execution results: (ga, ) + (WP) 
(ga, + 2) aa (PC) 
(old WP) ~ (Workspace register 13) 
(old PC) -- (Workspace register 14) 
(ST) + (Workspace register 15) 


Application notes: 

Use the BLWP instruction for linkage to subroutines, program modules, 
or other programs that do not necessarily share the calling program 
workspace. Refer to a subsequent paragraph for a detailed explanation 
and example. 


Return With Workspace Pointer RTWP 
Op Code: 0380 


Addressing mode: Format VII 


Format: 


9 10 1%9,;92 13 14 18 
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Application notes: 

Use the B instruction to transfer control to another section of code 
to change the linear flow of the program. For example, if the con- 
tents of workspace register 3 is 21CC} then the instruction 


B *3 
causes the word at location 21CC}¢ to be used as the next instruction, 
because this value replaces the contents of the PC when this instruc- 
tion is executed. 
Branch And Link _ BL 
Op Code: 0680 
Addressing mode: Format VI 


Format: 
O18 Sy A B67 BS to: 11 £0218" 14015 
felefete| ol abel sts sf «2 
Syntax definition: 
[xlabel>]b...BLb...<ga,>b... [<comment >] 
Example: 
LABEL BL (a)SUBR CALL SUBR AS A COMMON WS SUBROUTINE 
Definition: 
Place the source address in the program counter, place the address of 


the instruction following the BL instruction (in memory) in workspace 
register 11, and transfer control to the new PC contents. 


Status bits affected: None 


° 1 2 3 2 58. ©& 7? B @ 10 TE Ve £3. Bt 16 
/ 

INTERRUPT 

L>IA> Ov / MASK 


Execution results: ga, ~ (PC); 
(old PC) ~ (Workspace register 11) 


Application notes: 
Use the BL instruction when return linkage is required. For example, 
if the instruction 


BL (@ TRAN 


occurs at memory location (PC count) 04BC1,4, then this instruction has 
the effect of placing memory location TRAN in the PC and placing the 
value 04C0;¢ in workspace register 11. Refer to a subsequent paragraph 
for additional application notes. 
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The instructions are; 


Instruction Mnemonic Paragraph 
Branch B 3.24 
Branch and Link BL 3,25 
Branch and Load WP BLWP 3.26 
Jump if Equal JEQ 3,35 
Jump if Greater Than JGT 3.33 
Jump if High or Equal JHE 3.3] 
Jump if Logical High JH 3.29 
Jump if Logical Low JL 3.30 
Jump if Low or Equal JLE 3.32 
Jump if Less Than JLT 3.34 
Unconditional Jump JMP 3.28 
Jump if No Carry JNC 3.38 
Jump if Not Equal JNE 3.36 
Jump if No Overflow JNO 3.39 
Jump if Odd Parity JOP 3.40 
Jump On Carry JOC 3.37 
Return WP RTWP 3.27 
Execute X 3.41 


3.24 Branch _B 
Op Code: 0440 
Addressing mode: Format VI 


Format: 


Der stat 9 10 0 13 14 15 


Syntax definition: 

[<label>]b...Bb...<ga.>b... [<comment>] 
Example: 

LABEL B (@)THERE TRANSFER CONTROL TO LOCATION THERE 
Definition: 


Replace the PC contents with the source address and transfer control 
to the instruction at that location. 


Status bits affected: None 


B 8S TO 11 T2173 4 15 


SESosg cess /1G 


Execution results: gag — (PC) 
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Application notes: 

Use the NEG instruction to make the contents of an addressable memory 
location its additive inverse. For example, if workspace register 5 
contains the value A342),¢, then the instruction 


NEG 5 


changes the contents of workspace register 5 to 5CBE]6. The logical 
greater than and arithmetic greater than status bits set while the 
equal status bit resets. The overflow bit is set if the operand is 
8000;¢; otherwise, it resets. 


Jump And Branch Instructions 

Branch instructions transfer control either unconditionally, or accord- 
ing to the state of one or more status bits of the status register. 
Table 3-3 lists the conditional branch (jump) instructions and shows 
the status bit or bits tested. 


Table 3-3. Status Bits Tested by Instructions 


Mnemonic L> A> EQ C OV OP Jump if: 

JH X ~ + X is = = L>= 1 and EQ=0 
JHL X ~ X - ~ - L>= 0 and EQ = 0 
JHE X ~ X - = - L>= 1 or EQ=1 
JLE* X “ X i a - L>= 0 or EQ= 1 
JGT - X - a = ~ A>= 1 

JLT - x X - a wm A> = 0 and EQ = 0 
JEQ - = X = ” = EQ = 1 

JNE ~ = X - “ - EQ =0 

JOC - “ ~ X - a C= 1 

JNC = = - X “ - Cc =0 

JNO - - - - X ~ OV = 0 

JOP - - - ~ - X OP = 1 


* JLE is a logical comparison of jump if low or equal, not the arith- 
metic comparison. 
For all jump instructions, a displacement of zero results in execution 


of the next instruction in sequence. A displacement of -1 results in 
execution of the same instruction (a single-instruction loop). 
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However, the busy flag system is not fool proof. If two CPUs check the 
status of the busy flag in successive memory cycles, each CPU pro- 
ceeds as if it has exclusive access to memory. This conflict occurs 
because the first CPU does not set the flag until after the second 

CPU reads it. All instructions in the TA 1630 instruction set, except 
one, allow this problem to occur since they release memory which exe- 
cuting the instruction (i.e., while checking the state of the busy 
flag). However, the ABS instruction maintains control over memory even 
during execution of the instruction after the flag has been fetched 
from memory. This feature prevents other programs from accessing 
memory until the first program has evaluated the flag and has had a 
chance to change it. Therefore, use the ABS instruction to examine 
memory busy flags in all memory-sharing applications. 


The use of the ABS instruction in multiple CPU systems is similar to 
the subroutine control example presented in paragraph 3.89.1. 


Negate __NEG 
Op Code: 0500 


Addressing mode: Format VI 


Format: 


10 11,12 13 14 15 


Syntax definition: 
[Klabel>]b...NEGb...<ga >b... [<comment>] 
Example: 


LABEL NEG 2 _ REPLACE CONTENTS OF WSR2 WITH ITS 
ADDITIVE INVERSE 


Definition: 

Replace the source operand with the two's complement of the source 
operand. The AU determines the two's complement value by inverting 
all bits of the source operand and adding one to the resulting word. 
The AU then compares the result to zero and sets/resets the status 
bits to indicate the result of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and overflow. 


Wit213 14 15 


SCS a 


AAA 


Execution results: - (ga,) — (ga,) 
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Absolute Value ABS 
Op Code: 0740 
Addressing mode: Format VI 


Format: 


9 £0 t1¢12<13 14. 35 


Syntax definition: 
[<label>]b...ABSb...<gas>b... [<comment>] 
Example: 


LABEL ABS *2 REPLACE THE CONTENTS OF THE INDIRECT 
ADDRESS OF WSR2 WITH ITS ABSOLUTE VALUE 


Definition: 

Compute the absolute value of the source operand and replace the source 
operand with the result. The absolute value is the two's complement of 
the source operand when the sign bit (bit zero) is equal to one. When 
the sign bit is equal to zero, the source operand is unchanged. The AU 
compares the original source operand to zero and sets/resets the sta- 
tus bits to indicate the results of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


10 Tt 12033: ta oS 


BSSASESSS /// Gd 


Execution results: x —- (gas) 


Application notes: 

Use the ABS instruction to take the absolute value of an operand. For 

example, if the third word in array LIST contains the value FF3C;¢ and 
workspace register seven contains the value 416, then the instruction 


ABS (DLIST(7) 


changes the contents of the third word in array LIST to 00C41¢. The 
logical greater than status bit sets while the arithmetic greater than 
and equal status bits reset. The carry bit is unconditionally reset. 
The overflow bit is set if the operand is 8000,,; otherwise, it is re- 
set. Refer to a subsequent paragraph for additional application notes. 


Multiple CPU Systems: 

Several TA 1630 CPUs can be connected together to create a multiple CPU 
systems. In these systems, the CPUs must share a common memory. Simul- 
taneous access attempts to memory by more than one CPU can result in 

a loss of data. To prevent this conflict, software "memory busy" flags 
in memory can be used. When a program desires access to memory, it must 
first check the flag to determine if any other program is actively 
using memory. If memory is not busy, the program sets the busy flag 

to lock out other programs and begins its memory transfers. When the 
program is finished with memory, it clears the busy flag to allow 
access to other programs. 
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3.20 Decrement By Two DECT 


Op Code: 0640 
Addressing mode: Format VI 


Format: 
o 1 2 3,4 5S 6 748 9 10 11,12 13 14 15 
efefefefo| | fae s | = | 
Syntax definition: 


[<label>]...DECTb...<ga,.>b... [<comment>] 


Example: 


LABEL DECT (@ADDR SUBTRACT 2 FROM THE CONTENTS OF ADDR 


Definition: 

Subtract two from the source operand and replace the source operand 
with the result. The AU compares the result to zero and sets/resets 
the status bits to indicate the result of the comparison. When there 
is a carry out of bit zero, the carry status bit sets. When there is 
an overflow (the result cannot be represented in a word as a two's 
complement value), the overflow status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


o 1 2 3 4 S$ 6 7 8 9 10 11 1213 1415 
V 
L>|A> Ov INTERRUPT 
/ MASK 


Execution results: (gas) « 2 (gas) 


Application notes: 

The DECT instruction is useful in counting and indexing word arrays. 

Also, use the DECT instruction to subtract a value of two from any 
addressable operand. For example, if workspace register PRT (PRT equals 3) 
contains a value of 2€101 ¢, then the instruction 


DECT = PRT 


changes the contents of workspace register 3 to 2C0E;}¢. The logical 
greater than, arithmetic greater than and carry status bits set while 
the equal and overflow status bits reset. Refer to a subsequent para- 
graph for additional application notes. 
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3.19 Decrement DEC 
Op Code: 0600 
Addressing mode: Format VI 


Format: 


8 9 10 11,12 13 14 15 


Syntax definition: 
[<label>]b...DECb...<gag>b... [<comments>| 
Example: 
LABEL DEC 2 SUBTRACT 1 FROM THE CONTENTS OF WSR2 


Definition: 

Subtract a value of one from the source operand and replace the source 
operand with the result. The AU compares the result to zero and sets/ 
resets the status bits to indicate the result of the comparison. When 
there is a carry out of bit zero, the carry status bit sets. When there 
is an overflow (the difference cannot be represented in a word as a 
two's complement value), the overflow status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


10 11 12 13 14 15 


Execution results: (ga,) - 1 ~ (gag) 


Application notes: 

Use the DEC instruction to subtract a value of one from any addressable 
operand. The DEC instruction is also useful in counting and indexing 
byte arrays. For example, if COUNT contains a value of 116, then 


DEC (@ COUNT 


results in a value of zero in location COUNT and sets the equal and 
carry status bits while resetting the logical greater than, arithmetic 
greater than, and overflow status bits. The carry bit is always set 
except on transition from zero to minus one. Refer to a subsequent 
paragraph for additional application notes. 
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Execution results: (gas) + 1 — (gas) 


Application notes: 

Use the INC instruction to count and index byte arrays, add a value 
of one to an addressable memory location, or set flags. For example, 
if COUNT contains a zero, the instruction 


INC (a) COUNT 


places a 000116 in COUNT and sets the logical greater than and 
arithmetic greater than status bits, while the equal, carry, and 
overflow status bits reset. Refer to a subsequent paragraph for 
additional application notes. 


Increment By Two INCT 
Op Code: O5CO 


Addressing mode: Format VI 


Format: 


68 9 10 it412 13 1415 


Syntax definition: 
[<label>]6...INCTb...<gas>b... [<comment>] 
Example: 


LABEL INCT 3 ADD 2 TO THE CONTENTS OF WSR3 


Definition: 

Add a value of two to the source operand and replace the source operand 
with the sum. The AU compares the sum to zero and sets/resets the sta- 
tus bits to indicate the result of the comparison. When there is a 
carry out of bit zero, the carry status bit sets. When there is an 
overflow, (the sum cannot be represented in a 16-bit word as a two's 
complement value), the overflow status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


o.10 Tf 12 ISAS US 


AAAA 
Execution results: (gas) + 2 — (gas) 


Use the INCT instruction to count and index word arrays, and add the 
value of two to an addressable memory location. For example, if work- 
space register 5 contains the address (2100) ¢) of the fifteenth word 
of an array, the instruction 


INCT 5 
changes workspace register 5 to 210216, which points to the sixteenth 
word of the array. The logical greater than and arithmetic greater than 
status bits are set while the equal, carry, and overflow status bits are 
reset. Refer to a subsequent paragraph for additional application notes. 
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Application notes: 

Use the DIV instruction to perform a magnitude division. For example, 
if workspace register 2 contains a zero and workspace register 3 con- 
tains 000C;¢, and the contents of LOC is 0005;¢, then the instruction 


DIV (MLOC,2 


results in a 000216 in workspace register 2 and a 000216 in workspace 
register 3. The overflow status bit resets. If workspace register 2 
contained the value 000516, the magnitude contained in the destina- 
tion operand would equal 327,692 and division by the value 5 would 
result in a quotient of 65,538, which cannot be represented in a 16-bit 
word. This attempted division would set the overflow status bit and 

the AU would abort the operation. 


Increment _ INC 
Op Code: 0580 
Addressing mode: Format VI 


Format: 


Syntax definition: 


[<label>] b...INCb...<ga.>b... [<comment>] 


Example: 
LABEL INC (@ADDR(2)+ INCREMENT THE CONTENTS OF THE EFFECTIVE 
LOCATION. 
Definition: 


Add one to the source operand and replace the source operand with the 
result. The AU compares the sum to zero and sets/resets the status 
bits to indicate the result of the comparison. When there is a carry 
out of bit zero, the carry status bit sets. When there is an overflow 
(the sum cannot be represented in a 16-bit, two's complement value), 
the overflow status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


° 10.4) TAC 1TS Aa TS 


1 ee 3S 4A SS Ov, 8 2B 
/ i] 
L>|A> c j|ov MF Y INTERRUPT 
, MASK 
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Definition: 

Divide the destination operand (a consecutive 2-word area of workspace) 
by a copy of the source operand (one word), using integer rules, and 
place the quotient in the first of the 2-word destination operand area 
and place the remainder in the second word of that same area. This 
division is graphically represented as follows: 


Destination operand workspace registers 


WORKSPACE REGISTER (n) WORKSPACE REGISTER (nN+1) 


RESULTING Sa EnEEEIReeeseeie RESULTING REMAINDER 
QUOTIENT DIVIDEND 


Source operand ADDRESSABLE MEMORY 


The first of the destination operand workspace registers, shown above, 
is addressed by the contents of the D field. The dividend is located 
right-justified in this 2-word area. When the division is complete, 
the quotient (result) is placed in the first workspace register of 
the destination operand (represented by n above) and the remainder 

is placed in the second word of the destination operand (represented 
by n+] above). 


When the source operand is greater than the first word of the desti- 
nation operand, normal division occurs. If the source operand is less 
than or equal to the first word of the destination operand, normal 
division will result in a quotient that cannot be represented in a 
16-bit word. In this case, the AU sets the overflow status bit, leaves 
the destination operand unchanged, and aborts the division operation. 


If the destination operand is specified as workspace register 15, the 
first word of the destination operand is workspace register 15 and the 
second word of the destination operand is the word in memory immediately 
following the workspace area, 


Status bits affected: Overflow 


° 10 11 1213 14 145 


123 45 6 7 86 9 
y, 7 
L>|A> ov INTERRUPT 
A ___ MASK 


Execution results: 
The contents of wag and way + 1 (32-bit magnitude) are divided by the 


contents of ga, and the quotient is placed in way. The remainder is 
placed in wag + 1. 
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The first word of the destination operand shown above is addressed by 
the contents of the D field. This word contains the multiplicand 
(unsigned magnitude value of 16 bits) right-justified in the work- 
space register (represented by workspace n above). The 16-bit, un- 
signed multiplier is located in the source operand. When the multi- 
plication operation is complete, the product appears, right-justi- 
fied in the entire 2-word area addressed by the D field as a 32-bit 
unsigned magnitude value. The maximum value of either input operand 
is FFFF16 and the maximum value of the unsigned product is 

(168 - 2(164) + 1) or FFFEO001}¢. 


If the destination operand is specified as workspace register 15, the 
first word of the destination operand is workspace register 15 and 
the second word of the destination operand is the memory word imme- 
diately following the workspace memory area. 


Status bits affected: None 


Cf 23 4 SS 8 7 B- 3 vO A1, 12 13s 
/ / 
> y/ INTERRUPT 


Execution results: 
(gas) *- (wag). The product (32-bit magnitude) is placed in wag and 
wag + 1, with the most significant half in wag. 


Application notes: 

Use the MPY instruction to perform a magnitude multiplication. For 
example, if workspace register 5 contains 0012)¢, workspace register 
6 contains 1B311¢, and memory location NEW contains 0005;4, then the 
instruction 


MPY (Q)NEW, 5 


changes the contents of workspace register 5 to 0000;¢ and workspace 
register 6 to 005A;¢. The source operand is unchanged. The status 
register is not affected by this instruction. 


Divide DIV 


Op Code: 3C00 
Addressing mode: Format IX 


Format: 


Syntax definition: 
[<label>] b...DIVb...<ga.>,<way>b... [<comment>] 


Example: 
LABEL DIV (@ADDR(2),3 DIVIDE (WSR3, WSR4) BY (ADDR+(WSR2) ) 
AND STORE THE INTEGER RESULT IN WSR3 
WITH THE REMAINDER IN WSR4. 
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Execution results: (gag) = (gas) — (gag) 


Application notes: 
Use the SB instruction to subtract signed integer bytes. For example, 
if workspace register 6 contains the value 121C;¢, memory location 
121C1¢ contains the value 233116, and workspace register 1 contains 
the value 134416, then the instruction 

SB *6+,1 


results in the contents of workspace register 6 changing to 121D16 and 
the contents of workspace register 1 changing to F044,¢. The logical 
greater than status bit sets while the other status bits affected by 


this instruction reset. 


Multipl MPY 
Op Code: 3800 


Addressing mode: Format IX 


o 1 2 3,4 5 6 7,8 9 10 11j12 1314 15 
efef ff fe] es fet = | 
Syntax definition: 


<label>]®...MPYb...<ga.>,<wag>b... <comment>] 
s d 


Format: 


Example: 


LABEL MPY (@ADDR,3 MULTIPLY (WSR3) BY (ADDR). THE RESULT 
IS RIGHT JUSTIFIED IN THE 32-BITS OF 
WSR3, WSR4, 


Definition: 

Multiply the first word in the destination operand (a consecutive 
2-word area in workspace) by a copy of the source operand and replace 
the 2-word destination operand with the result. The multiplication 
operation may be graphically represented as follows: 


Destination operand workspace registers 


WORKSPACE REGISTER (n) WORKSPACE REGISTER (n+1) 


ULTIPLICAND———————»} 
RODUCT 


Source operand 
SOURCE OPERAND 


ADDRESSABLE MEMORY 


jee MULTIPLIER ————s] 
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Execution results: (gag) - (ga,) + (gag) 


Application notes: 

Use the S instruction to subtract signed integer values. For example, 
if memory location OLDVAL contains a value of 1225)¢ and memory lo- 
cation NEWVAL contains a value of 822314, then the instruction 


S  @OLDVAL, (@)NEWVAL 


results in the contents of NEWVAL changing to 6FFE}¢. The logical 
greater than, arithmetic greater than, carry, and overflow status bits 
set while the equal status bit resets. 


3.14 Subtract Bytes SB 
Op Code: 7000 


Addressing mode: Format I 


Format: 


Syntax definition: 
[<label>] 6...SBb...<gag>,<gag>b... [kcomment> 
Example: 


LABEL SB 2,3 SUBTRACT THE LEFTMOST BYTE OF WSR2 FROM THE 
LEFTMOST BYTE OF WSR3 


Definition: 

Subtract a copy of the source operand (byte) from the destination 
operand (byte) and replace the destination operand byte with the dif- 
ference. When the destination operand byte is addressed in the work- 
space register mode, only the leftmost byte (bits 0-7) in the workspace 
register is used. The AU compares the result byte to zero and sets/ 
resets the status bits accordingly. When there is a carry out of the 
most significant bit of the byte, the carry status bit sets. When 

there is an overflow (the difference cannot be represented as an 8-bit, 
two's complement value in a byte), the overflow status bit sets. If 
the result byte establishes odd parity (an odd number of logic one 
bits in the byte), the odd parity status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, overflow, 
and odd parity. 


8 DB. T0.-97) 12 713 146,95 


SSSaSS0So///E 
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Execution results: (wa) + iop — (wa) 


Application notes: 
Use the AI instruction to add an immediate value to the contents of a 


workspace register. For example, if workspace register 6 contains a 
zero, then the instruction 
AI 6,>C 


changes the contents of workspace register 6 to 000C) ¢. The logical 
greater than and arithmetic greater than status bits set while the 
equal, carry, and overflow status bits reset. 


Subtract Words 5 
Op Code: 6000 
Addressing mode: Format I 


Format: 
~ 0 f 2.394 BS .6_ 74 8 9 10 19412 .13.14 18 
DEStE a eee Ee ee 
Syntax definition: 
[<label>]®...Sb...<gag>,<gaj>b... [<comment>] 


Example: 


LABEL S 2,3 SUBTRACT THE CONTENTS OF WR2 FROM THE 
CONTENTS OF WR3 


Definition: 

Subtract a copy of the source operand from the destination operand and 
place the difference in the destination operand. The AU compares the 
difference to zero and sets/resets the status bits to indicate the re- 
sult of the comparison. When there is a carry out of bit zero, the 
carry status bit sets. When there is an overflow (the difference can- 
not be represented within a word as a two's complement value), the 
overflow status bit sets. The source operand remains unchanged. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and 
overflow. 


° 9 10 11 f2 13 7413S 


{2s 48 & 7 & 
y/ INTERRUPT 
L>|A> c }] ov Y re 
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S80 01 2 US 0t4-13 


SC OeSC OSS Gua 


Execution results: (ga,) + (gay) — (gag) 


Application notes: 

AB is used to add signed integer bytes. For example, if the contents 
of workspace register 3 is 7400;¢, the contents of memory location 
212214 is F31816, and the contents of workspace 2 is 212316, then the 
instruction 


AB 3,*2+ 


changes the contents of memory location 2122)¢ to F38C)¢ and the con- 
tents of workspace register 2 to 21246, while the contents of work- 
space register 3 remain unchanged. The logical greater than, overflow, 
and odd parity status bits set, while the arithmetic greater than, 
equal, and carry status bits reset. 


Add Immediate AI 
Op Code: 0220 
Addressing mode: Format VIII 


Format: 


SOGE Thy: 10 of 13:14 15 


Syntax definition: 
[<label>]6...AIb...<wa>,<iop>b... [<comment >] 


Example: 
LABEL AI 2,7 ADD 7 TO THE CONTENTS OF WSR2 


Definition: 

Add a copy of the immediate operand, the contents of the word following 
the instruction word in memory, to the contents of the workspace re- 
gister specified in the W field and replace the contents of the work- 
space register with the results. The AU compares the sum to zero and 
sets/resets the status bits to indicate the result of the comparison. 
When there is a carry out of bit zero, the carry status bit sets. When 
there is an overflow (the result cannot be represented within a word 

as a two's complement value), the overflow status bit sets. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and over- 


flow. 


9 TO 71 1213 14 15 


SEOOSSS2 /// Gra 
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Status bits affected: 


Logical ae aia pais greater than, equal, carry, and overflow. 


9.0 ft1 12 13 14 3 


SSE SS 


Execution results: (gas) + (gay) — (gay) 


Application notes: 
A is used to add signed integer words. For example, if the address 


labeled TABLE contains 312416 and workspace register 5 contains 81¢, 
then the instruction 
A 5, (@)TABLE 


results in the contents of TABLE changing to 312C16 and the contents of 
workspace register 5 not changing. The logical and arithmetic greater 
than status bits set and the equal, carry, and overflow status bits 
reset. 


Add Bytes AB 
Op Code: BOOO 


Addressing mode: Format I 


Format: 


o 14 2 S34 SS G6 7, 8 @ 10 10,982 U3 %4 4B 


Syntax definition: 
Klabel>] 6...ABb...<gas>,<gag>b... [<comment>] 


Example: 
LABEL AB 3,2 


Definition: 

Add a copy of the source operand (byte) to the destination operand 
(byte), and replace the destination operand with the sum. When the 
destination operand is addressed in the workspace register mode, only 
the leftmost byte (bits 0-7) of the addressed workspace register is 
used. The AU compares the sum to zero and sets/resets the status bits 
to indicate the results of the comparison. When there is a carry out 
of the most significant bit of the byte, the carry status bit sets. 
When there is an overflow (the sum cannot be represented within a 

byte as an 8-bit two's complement value), the overflow status bit sets. 
The odd parity bit sets when the bits in the sum (destination operand) 
establish odd parity and resets when the bits in the sum establish 
even parity. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, overflow 
and odd parity. 


3.9 Arithmetic Instructions 


3.10 
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The arithmetic instructions are described in the following paragraphs. 


The instructions are: 


Instruction 

Add Words 

Add Bytes 
Absolute Value 
Add Immediate 
Decrement 
Decrement by Two 
Divide 

Increment 
Increment by Two 
Multiply 

Negate 

Subtract Words 
Subtract Bytes 


Add Words A 
Op Code: A000 


Addressing mode: Format I 


Format: 


Mnemonic 


Paragraph 
3.10 
3.11 
3.21 
33.12 
3.19 
3.20 
3.16 
3.17 
3.18 
3.15 
3.22 
3.13 
3.14 


9 10 11412 13 14 15 


Syntax definition: 


[<label>]6...Ab...<ga.>,<gag>b... [<comment>] 


Example: 


LABEL A (@ADDR1(R2), (@ ADDR2(R3) 


Definition: 


Add a copy of the source operand (word) to the destination operand 
(word) and replace the destination operand with the sum. The AU com- 
pares the sum to zero and sets/resets the status bits to indicate the 
result of the comparison. When there is a carry out of bit zero, the 
carry status bit sets. When there is an overflow (the sum cannot be 
represented as a 16-bit, two's complement value), the overflow status 


bit sets. 
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The syntax definition for each instruction is shown, using the conven- 
tions described in a previous paragraph. The generic names used in 
these definitions are: 


e ga, - General address of source operand 

e@ gay - General address of destination operand 

e wa —- Workspace register address 

e iop - Immediate operand 

e wa, - Destination workspace register address 

e disp - Displacement of CRU lines from the CRU base register 
e exp - Expression that represents an instruction location. 
e cnt - Count of bits for CRU transfer 

e m — Memory map file 

e scent - Shift count 

@ op - Number (0-15) of extended operation 


Source statements that contain machine instructions use the label field, 
the operation field, the operand field, and the comment field. Use of 
the label field is optional for machine instructions. When the label 
field is used, the label is assigned the address of the machine in- 
struction. The assembler advances the location to a word boundary 

(even address) before assembling a machine instruction. The operation 
(opcode) field contains the mnemonic operation code of the instruction. 
The contents of the operand field is defined for each instruction. The 
use of the comment field is optional. When the comment field is used, 
it may contain any ASCII character, including blank, and has no effect 
on the assembly process other than to be printed in the listing. 


A description of the operation of the instruction follows the syntax 
definition. The status bits affected by the instruction are listed. In 
the execution results, the following conventions are used: 


e () Indicates "the contents of" 
e -— Indicates "replaces" 
e ll Indicates the absolute value 


The generic names used in the syntax definitions are also used in the 
execution results. 


Application notes are included, referring to a fuller explanation in 
the programming examples paragraphs as appropriate. 


The Op Code given for each instruction is a four hexadecimal digit 
number corresponding to an instruction word in which the address 
fields contain zeros. Next is the addressing mode. The instruction 
formats show the machine language form of the instruction, and use 
the terminology previously defined for the addressing formats. 
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3.7.12 Format X - Memory Map File Instruction 


The operand field of a Fomart X Memory Map File instruction contains 
a workspace register address followed by a comma and a well defined 
expression which evaluates to either a 0 or a 1. The workspace regi- 
ster address specifies a workspace register that contains the address 
of a six-word area of memory that contains the map file data. The 
term specifies the map file into which the data is to be loaded. The 
mnemonic operation code is LMF. 


The following example shows a source statement for a Format X Memory 
Map File instruction: 


LMF R4,0 Load memory map file O with the six-word 
area of memory at the address in workspace 
register 4, 


The assembler assembles a Format X instruction as follows: 


Oo ff 2 3.4 *§ __6..7 3 0 10 31-12 15.78.15 


The bit fields are: 
e Op Code - Eleven bits that define the machine operation. 
e M-A single bit that specifies a memory map file, O or 1. 


e W - Workspace register operand. 


3.8 Instruction Descriptions 


The instruction descriptions in the following paragraphs are divided 
into the following functional categories: 


e Arithmetic Instructions 

e Branch Instructions 

e Compare Instructions 

e Control and CRU Instructions 

e Load and Move Instructions 

e Logical Instructions 

e Shift Instructions 

e Extended Operation Instruction 


e Long Distance Addressing Instructions 
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3.7.10 Format IX - Extended Operation Instruction 


3.7511 


The operand field of a Format IX Extended Operation instruction con- 
tains a general address and a well defined expression. The general 
address is the address of the operand extended operation. The term 
specifies the extended operation to be performed and must be in the 
range of 0 to 15. The mnemonic operation code is XOP. 


The following example shows a source statement for a Format IX 
Extended Operation instruction: 


XOP @LABEL(R4),12 Perform extended operation 12 using the 
address computed by adding the value of 
symbol LABEL to the contents of work- 
space register 4, 


The assembler assembles Format IX instructions as follows: 


© 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


The bit fields are: 

e@ Op Code - Six bits that define the machine operation. 
e D - Four bits that define the extended operation. 

e T, - Addressing mode (table 3-1) for source. 

e S - Source workspace register. 


When T, is equal to 109, the instruction occupies two words of memory. 
The second word contains the memory address for the source operand. 


Format IX - Multiply and Divide Instructions 


The operand field of Format IX Multiply and Divide instructions contains 
a general address followed by a comma and a workspace register address. 
The general address is the address of the multiplier or divisor, and 

the workspace register address is the address of the workspace regi- 
ster that contains the multiplicand or dividend. The workspace regi- 
ster address is also the address of the first of two workspace regi- 
sters to contain the result. The mnemonic operation codes are MPY 

and DIV, 


The following example shows a source statement for a Format IX Mul- 
tiply instruction: 


MPY (@)ACC,R9 Multiply the contents of workspace register 
9 by the contents of the word at location ACC, 
and place the product in workspace registers 
9 and 10, with the 16 least significant bits 
of the product in workspace register 10. 


The assembler assembles Multiply and Divide instructions similarly to 
the format shown in the preceding paragraph, except that the D field 
contains the workspace register operand. 


3/12 


3.7.9 Format VIII - Immediate Instructions 


The operand field of Format VIII instructions contains a workspace 
register address followed by a comma and an expression. The work- 
space register is the destination address, and the expression is 
the immediate operand. The following mnemonic operation codes use 
Format VIII: 


AI CI ORT 
ANDI LI 


There are two additional Format VIII instructions that require only 
an expression in the operand field. The expression is the immediate 
operand. The destination is implied in the name of the instruction. 
The following mnemonic operation codes use this modified Format VIII: 


LIMI LWPI 


Another modification of Format VIII requires only a workspace regi- 
ster address in the operand field. The workspace register address 
is the destination. The source is implied in the name of the in- 
struction. The following mnemonic operation codes use this modi- 
fied Format VIII: 


STST STWP 
The following are examples of source statement for Format VIII in- 
structions: 
ANDI 4,>000F Perform an AND operation on the contents 


of workspace register 4 and immediate 
operand OOOF, ¢. 


LWPI WRKI Place the address defined for the symbol 
WRKI into the WP register. 


STWP R4 Place the contents of the WP register into 
workspace register 4. 


The assembler assembles Format VIII instructions as follows: 


o 1 23 4 8 6:7 8 & 40° tf t2°03) t4 15 


The bit fields are: 
e Op Code - Eleven bits that define the machine operation. 
e W - Workspace register operand. 


A zero bit separates the two fields. The instructions that have no 
workspace register operand place zeros in the W field. The instruc- 
tions that have immediate operands place the operands in the word 
following the word that contains the Op Code; i.e., these instruc- 
tions occupy two words each. 
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3.7.7 Format VI - Single Address Instructions 


3.7.8 
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The operand field of Format VI instructions contains a general 
address. The following mnemonic operation codes use Format VI: 


ABS CLR INCT NEG 
B DEC INV SETO 
BL DECT LDD SWPB 
BLWP INC LDS X 


The following example shows a source statement for a Format VI 
instruction: 


CNT INC R7 Adds one to the contents of workspace re- 


gister 7, and places the sum in workspace 
register 7. CNT is the location into which 
the instruction is placed. 

The assembler assembles Format VI instructions as follows: 


o 123 4 S$ 6 7 8 9 10 1112 13 14 15 


ee “ 


The bit fields are: 

e@ Op Code - Ten bits that define the machine operation. 
e T, - Addressing mode (table 3-1) for source. 

e S - Source workspace register. 


When T, is equal to 109, the instruction occupies two words of me- 
mory. The second word contains the memory address for the source 
operand, 


Format VII - Control Instructions 


Format VII instructions require no operand field. The following ope- 
ration codes use Format VII: 


CKOF IDLE RSET 
CKON LREX  RTWP 


The following example shows a source statement for a Format VII 
instruction: 


RTWP Returns control to the calling program, 
and restores the context of the calling 
program by placing the contents of work- 
space registers 13, 14, and 15 into the 


WP register, the PC, and the ST register. 


The assembler assembles Format VII instructions as follows: 


° 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


The Op Code field contains eleven bits that define the machine ope- 
ration. The five least significant bits are zeros. 
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The assembler assemblesFormat IV instructions as follows: 
6 7 8 9 10111213 14 15 


COr-n1 2.2 2278 


The bit fields are: 

e Op Code - Six bits that define the machine operation. 
e C - Four bits that contain the bit count. 

e T, - Addressing mode (table 3-1) for source. 

e S = Source workspace register. 


When Tg is equal to 105, the instruction occupies two words of memory. 
The second word contains the memory address for the source operand. 


Format V - Register Shift Instructions 


The operand field of Format V instructions contains a workspace re- 
gister address followed by a comma and a well defined expression. 
The contents of the workspace register are shifted a number of bit 
positions specified by the term. When the term equals zero, the 
shift count must be placed in bits 12-15 of workspace register 0. 
The following mnemonic operation codes use Format V: 


SLA = SRC SRL SRA 


The following example shows a source statement for a Format V in- 
struction: 


SLA R6,4 Shift contents of workspace register 6 to 
the left 4 bit positions, replacing the 
vacated bits with zero. 


The assembler assembles Format V instructions as follows: 
Onik : 2 Bows B., 6.2% ,.8. F 10 F. 3S. F514 35 


The bit fields are: 
e@ Op Code - Eight bits that define the machine operation. 
e C - Four bits that contain the shift count. 


e W - Workspace register to be shifted. 
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3.7.4 Format III - Logical Instructions 


3.7.5 


The operand field of Format III instructions contains a general 
address followed by a comma and a workspace register address. The 
general address is the source address, and the workspace register 
address is the destination address. The following mnemonic opera- 
tion codes use Format III: 


coc CZC XOR 


The following example shows a source statement for a Format III 
instruction: 


COMP XOR @LABEL8(R3),R5 Perform an exclusive OR operation of the 
contents of a memory word and the con- 
tents of workspace register 5, and place 
the result in workspace register 5. The 
address of the memory word is the sum of 
the contents of workspace register 3 and 
the value of symbol LABEL8. 


The assembler assembles Format III instructions as follows: 


o 1 2 3 4 &§ 6 7 86 9g 10 11 1213 14 15 


The bit fields are: 

e Op Code - Six bits that define the machine operation. 
e D - Destination workspace register. 

e T, - Addressing mode (table 3-1) for source. 

e S = Source workspace register. 


When T, is equal to 105, the instruction occupies two words of me- 
mory. The second word contains the memory address for the source 
operand, 


Format IV - CRU Instructions 


The operand field of Format IV instructions contains a general 
address followed by a comma and a well defined expression. The ge- 
neral address is the memory address from which or into which bits 
will be transferred. The CRU address for the transfer is the con- 
tents of bits 3 through 14 of workspace register 12. The term is 
the number of bits to be transferred, a value of O through 15 (a 0 
value transfers 16 bit). For 8 or fewer bits the effective address 
is a byte address. For 9 or more bits the effective address is a 
word address. The following mnemonic operation codes use Format IV: 


LDCR STCR 


The following example shows a source statement for a Format IV 
instruction: 


LDCR *R6+,8 Place 8 bits from the byte of memory at 
the address in workspace register 6 into 
eight consecutive CRU lines at the CRU 
base address in workspace register 12. 


3.7.2 


3.7.3 
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Format II ~ Jump instructions 


Format II instructions use program counter relative addresses which 
are coded as expressions that correspond to instruction locations 
on word boundaries. The following mnemonic operation codes are 
Format II jump instructions: 


JEQ JLE JNE 
JGT JLT JNO 
JH JMP JOC 
JHE  JNC JOP 
JL. 


The following is an example of a source statement for a Format II 
jump instruction: 


NOW JMP G) BEGIN Jumps unconditionally to the instruction 
at location BEGIN. The address of location 
BEGIN must not be greater than the address 
of location NOW by more than 127 words, nor 
less than the address of location NOW by 
more than 128 words. 


The assembler assembles Format II instructions as follows: 


Oo 1 2. 3 4,35  6'"4 6 9 $0 41 42 $344 18 


OP CODE DISPLACEMENT 


The bit fields are: 
e Op Code - Eight bits that define the machine operation. 
e Displacement - Signed displacement value. 


The signed displacement value is shifted one bit position to the 
left and added to the contents of the PC after the PC has been 
incremented to the address of the following instruction. In other 
words, it is a displacement in words from the sum of the instruc- 
tion address plus two. 


Format II - Bit I/0 Instructions 


The operand field of Format II CRU bit I/0 instructions contains a 
well-defined expression. It is a CRU bit address, relative to the 
contents of workspace register 12. The following mnemonic operation 
codes are Format II CRU bit I/0 instructions: 


SBO SBZ TB 


The following example shows a source statement for a Format II CRU 
bit 1/0 instruction: 


SBO 5 Sets a CRU bit to one. If workspace regi- 
ster 12 contains 2016, CRU bit 13 is set 
by this instruction. 


The format assembled for Format II instructions is shown and des- 
cribed in the preceding paragraph. For CRU bit instructions the 
signed displacement is shifted one bit position to the left and 
added to the contents of workspace register 12. In other words, it 
is a displacement in bits from the contents of bits 3 through 14 
of workspace register 12. 
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3.7 Addressing Formats 


3.7.1 


The required addressing previously described relates to the ten 
addressing formats of the TA 1630 Computer. These formats are 
shown and described in the following paragraphs. 


Format I - Two Address Instructions 


The operand field of Format I instructions contains two general 
addresses separated by a comma. The first address is the source 
address; the second is the destination address. The following 
mnemonic operation codes use Format I. 


A MOV SOC 
AB MOVB SOCB 
C S SZC 
CB SB SZCB 


The following example shows a source statement for a Format I 
instruction: 


SUM A  (@)LABEL1,*R7 Adds the contents of the word at location 
LABEL] to the contents of the word at the 
address in workspace register 7, and places 
the sum in the word at the address in work- 
space register 7, SUM is the location in 
which the instruction is placed. 


The assembler assembles Format I instructions as follows: 


7 8 9 10 11 12:93 14 18 


2 
sinsiami maple 2 ia at 


The bit fields are: 
e Op Code - Three bits that define the machine operation. 


e B - Byte indicator, 1 for byte instructions, O for word 
instructions. 


e Ty- Addressing mode (table 3-1) for destination. 
e D - Destination workspace register. 

e Ts- Addressing mode (table 3-1) for source. 

e S - Source workspace register. 


When T, or Tg is equal to 1092, the instruction occupies two words of 
memory, and the second word contains a memory address used with S or 
D, respectively, in developing the effective address. When both Ts 
and Tyg are equal to 105, the instruction occupies three words of 
memory. The second word contains the memory address for the source 
operand, and the third word contains the memory address for the 
destination operand. 
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Table 3-2. Instruction Addressing 


First Second First Second 
Mnemonic Operand Operand Mnemonic Operand Operand 
A G Ge LDCR G Note 1 
AB G G* LDD G - 
ABS G - LDS G = 
AI WR* I LI WR* I 
ANDI WR* I LIMI I = 
B G = LMF WR* Note 2 
BL G - LREX on = 
BLWP G - LWPI I “ 
C G G MOV G G* 
CB G G MOVB G G* 
on WR I MPY G WR* 
CKOF - - NEG G is 
CKON - ORI WR* I 
CLR G - RSET = < 
Coc G WR RTWP - - 
CZC G WR S G G* 
DEC G = SB G G* 
DECT G - SBO CRU = 
DIV G WR* SBZ CRU . 
IDLE - “i SETO G = 
INC G - SLA WR* Note 3 
INCT G - SOC G G* 
INV G - SOCB G G* 
JEQ PC = SRA WR* Note 3 
JGT PC - SRC WR* Note 3 
JH PC = SRL WR* Note 3 
JHE PC = STCR G* Note 1 
JL PC - STST WR _ 
JLE PC - STWP WR es 
JLT PC = SWPB G 3 
JMP PC ~ SZC G G* 
JNC PC “ SZCB G G* 
JNE PC - TB CRU - 
JNO PC - X G - 
JOC PC - XOP G Note 4 
JOP PC - XOR G WR* 
Notes: 


1. The second operand is the number of bits to be transferred, 0-15, 
0 = 16 bits. 


2. The second operand specifies a memory map file, O or 1. 
3. The second operand is the shift count, 0-15. 0 means count is in 


bits 12-15 of workspace register 0. When count = O and bits 12-15 
of workspace register O = 0, count is 16. 


4, Second operand specifies the extended operation, 0-15. Disposition 
of result may or may not be in the first operand address, deter- 


mined by the user. 
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Program counter relative address 
Communications Register Unit (CRU) bit address 
Immediate value 


The address into which the result is placed, when two 
operands are required. 


3.4 


3.5 


3.6 
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CRU Bit Addressing 


The CRU bit instructions use a well-defined expression that represents 
a displacement from the CRU base address (bits 3 through 14 of work- 
space register 12). The displacement, in the range of -128 through 
+127, is added algebraically to the base address in workspace re- 
gister 12. The following are examples of CRU bit instructions having 
CRU bit addresses: 


SBO «8 Sets CRU bit to one at the CRU address 8 
greater than the CRU base address. If work- 
space register 12 contained 0020 6 CRU bit 
24 would be set by this instruction. 


(24 = (20)¢/2) + 8) 


SBZ DTR Sets CRU bit to zero. Assuming that DTR has 
the value 10, and workspace register 12 con- 
tains 0040)¢, the instruction sets bit 42 to 
zero. (42 = (40;¢/2) + 10) 


Immediate Addressing 


Immediate instructions use the contents of the word following the 
instruction word as an operand of the instruction. The immediate 
value is an expression,and the value of the expression is placed 
in the word following the instruction by the assembler. Those im- 
mediate instructions that require two operands have a workspace 
register address preceding the immediate value. The following are 
examples of coding immediate instructions: 


LIMI 5 Places 5 in the interrupt mask, enabling 
interrupt levels O through 5. 
LI R5,>1000 Places 1000, ¢ into workspace register 5. 
NOTE 


An @ sign may preceed an immediate operand. 


Adressing Summary 


Table 3-2 shows the addressing required for each instruction of the 
TA 1630 instruction set. The first column lists the instruction 
mnemonics, and second and third columns specify the required address, 
as follows: 
e G - General address: 

Workspace register address 

Indirect workspace register address 

Symbolic memory address 

Indexed memory address 


Indirect workspace register auto-increment address 


e WR- Workspace register address 
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MOV R7, @LIST4-6(R5) Copy the contents of workspace register 7 into 
a word of memory. The address of the word of 
memory is the sum of the contents of workspace 
register 5 and the value of symbol LIST4 minus 6. 


Workspace Register Indirect Auto-Increment Addressing 


Workspace register indirect auto-increment addressig specifies a 
workspace register that contains the address of the operand. After 
the address is obtained from the workspace register, the workspace 
register is incremented by 1 for a byte instruction or by 2 for a 
word instruction. The workspace register increment is one for byte 
operations and two for word operations. A workspace register auto- 
increment address is written as a term preceded by an asterisk and 
followed by a plus sign (+). The following are coding examples of 
instructions having workspace register indirect auto-increment 
addresses: 


S *R3+,R2 Subtract the contents of the word at the 
address in workspace register 3 from the 
contents of workspace register 2, place the 
result in workspace register 2, and increment 
the address in workspace register 3 by two. 


C  R5,*R6+ Compare the contents of workspace register 5 
with the contents of the word at the address 
in workspace register 6, and increment the 
address in workspace register 6 by two. 


Program Counter Relative Addressing 


Program counter relative addressing is used by the jump instructions. 
A program counter relative address is written as an expression that 
corresponds to an address at a word boundary. The assembler evaluates 
the expression and subtracts the sum of the current location plus 
two. One-half of the difference is the value that is placed in the 
object code. This value must be in the range of -128 through +127. 
When the instruction is in relocatable code (that is, when the lo- 
cation counter is relocatable), the relocation type of the evaluated 
expression must match the relocation type of the current location 
counter. When the instruction is in absolute code, the expression 
must be absolute. The following example shows a program counter re- 
lative address: 


JMP = THERE Jumps unconditionally to location THERE. 


3.2.2 


3.2.3 


3.2.4 
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Workspace Register Indirect Addressing 


Workspace register indirect addressing specifies a workspace register 
that contains the address of the operand. An indirect workspace re- 
gister address is written as a term preceded by an asterisk (*). The 
following example shows coding of instructions having workspace re- 
gister indirect addresses, 


A *R7,*R2 Add the contents of the word at the address 
in workspace register 7 to the contents of 
the word at the address in workspace regi- 
ster 2, and place the sum in the word at 
the address in workspace register 2. 


MOV +R7,RO Copy the contents of the address in work- 
space register 7 into workspace register 0. 


Symbolic Memory Addressing 


Symbolic memory addressing specifies the memory address that contains 
the operand. A symbolic memory address is written as an expression 
preceded by an at sign ((q@)). The following are coding examples of 
instructions having symbolic memory addresses: 


S @TABLE], @LIST4 Subtract the contents of the word at location 
TABLE] from the contents of the word at loca- 
tion LIST4, and place the remainder in the 
word at location LIST4. 


C RO, @ STORE Compare the contents of workspace register 0 
with the contents of the word at location 
STORE. 
MOV @)12, (@)>7C Copy the word at address 000C16 into location 
007C1 6. 
NOTE 


Symbols previously defined as having relocatable values or 
values greater than 15 need not have the '@'. 


Indexed Memory Addressing 


Indexed memory addressing specifies the memory address that contains 
the operand. The address is the sum of the contents of a workspace 
register and a symbolic address. An indexed memory address is written 
as an expression preceded by an at sign and followed by a term en- 
closed in parentheses. The workspace register specified by the term 
within the parentheses is the index register. Workspace register 0 
may not be specified as an index register. The following are examples 
of coding of instructions having indexed memory addresses: 


A (a) 2(R7),R6 Add the contents of the word at the address 
computed by adding the contents of workspace 
register 7 and 2 to the contents of workspace 
register 6, and place the sum in workspace 
register 6. 
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3 ASSEMBLY INSTRUCTIONS 


3.1 General 


This section describes the mnemonic instructions of the assembly 
language for the SDSMAC assembler. Detailed assembly instruction 
descriptions follow descriptions of the addressing modes used in 
the assembly language and the addressing formats of the assembly 
instructions. The section also includes examples of programming the 
various instructions. 


3.2 Addressing Modes 


One of five addressing modes may be used in the instructions that 
specify a general address for the source or destination operand. 
Table 3-1 lists these modes and shows how each is used in the assem- 
bly language. Each of the modes is described in a subsequent para- 
graph. 


Table 3-1. Addressing Modes 
T field value 


Addressing Mode (Note 1) Example Note 
Workspace Register fe) 5 

Workspace Register Indirect 1 7 

Symbolic Memory 2 (@LABEL 2,3 
Indexed Memory 2 (MLABEL(5) 2,4 
Workspace Register 3 *7+ 


Indirect Autoincrement 
Notes: 
1. The T field is described in the addressing format description. 


2. The instruction requires an additional word for each T field 
value of 2. This word contains a memory address. 


3. The S or D field is set to zero by the assembler. 


4, Workspace register 0 cannot be used for indexing. 


3.2.1 Workspace Register Addressing 


Workspace register addressing specifies a workspace register that 
contains the operand. A workspace register address is written as a 
term having a value of O through 15. 


The following examples show the coding of instructions that have two 
workspace register addresses each: 


MOV R4,R8 Copy the contents of workspace register 4 
into workspace register 8. 


COC R15,R10 Compare the bits of workspace register 10 
that correspond to the one bits in work- 
Space register 15 to one. 
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The following are examples of valid terms: 


12 The value is 12, or Cy. 

>C The value is 12, or Cig: 

WR2 Valid if WR2 is defined having an absolute valve. 
R3 Predefined as a value of 3, 


If START were a relocatable symbol, the following statement would not be 
valid as a term: 


WR2 EQU  START+4 WR2 would be a relocatable value 4 greater 
than the value fSTART. Not valid as a term, 
but valid as a symbol. 


Character Strings 


Several assembler directives require character strings in the operand 
field, A character string is written as a string of characters enclosed 
in single quotes, For each single quote in a character string, two con- 
secutive single quotes are required to represent the required single 
quote. The maximum length of the string is defined for each directive 
that requires a character string. The characters are represented inter- 
nally as eight-bit ASCII characters, with the leading bits set to zeros. 
Appendix A gives a complete list of valid characters within character 
strings. . 


The following are valid character strings: 


"SAMPLE PROGRAM' Defines a 14-character string consisting 
of: 
SAMPLEbBPROGRAM 


"PLAN *"Cr"* Defines an 8-character string consisting 
of : 


PLANtD* C *, 


"OPERATOR MESSAGE * PRESS Defines a 36-character string consisting 
START SWITCH' of the expression enclosed in single 
quotes. 
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Symbols 


Symbols are used in the label field, the operator field, and the operand 
field, A symbol is a string of alphanumeric characters, (A through Z and 
0 through 9), the first of which must be an alphabetic character (A 
through Z), and none of which may be a blank. When more than six cha- 
racters are used in a symbol, the assembler prints all the characters, 
but accepts only the first six characters for processing. User-defined 
symbols are valid only during the assembly in which they are defined. 


Symbols used in the label field become symbolic addresses, They are 
associated with locations in the program, and must not be used in the 
label field of other statements. Mnemonic operation codes and assembler 
directive names are valid user-defined symbols when placed in the label 
field, 


NOTE 
The ';' and '$' characters are considered alphabetic, 


The DXOP directive defines a symbol to be used in the operator field, 
Any symbol that is used in the operand field must be placed in the label 
field of a statement, or in the operand field of a REF directive except 
for a symbol in the operand field of a DXOP directive or a predefined 
symbol. 


Predefined Symbols 


The predefined symbols are the dollar sign character ($) and the work- 

space register symbols, The dollar sign character is used to represent 

the current location within the program, The workspace register symbols 
are as follows: 


Symbol Value Symbol Value Symbol Value Symbol Value 


RO ) R4 4 R8 8 R12 12 

R1 1 R5 5 R9 9 R13 13 

R2 2 R6 6 R10 10 R14 14 

R3 3 R7 7 R11 11 R15 15 

The following are examples of valid symbols: 

START Assigned the value of the location at which it appears 
in the label field. 

Al Assigned the value of the location at which it appears 
in the label field, 

OPERATION OPERAT is assigned the value of the location at which 
it appears in the label field, 

$ Represents the current location, 

Terms 


Terms are used in the operand fields of machine instructions and an as- 
sembler directive. A term is a decimal or hexadecimal constant, an abso- 
lute assembly-time constant, or label having an absolute valve. 
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Decimal Integer Constants 


A decimal integer constant is written as a string of numerals. The range 
of values of decimal integers is -32,768 to +65,535, Positive decimal 
integer constants greater than 32,767 are considered negative when inter- 
preted as two's complement values. Operands of arithmetic instructions 
other than multiply and divide are interpreted as two's complement num- 
bers, and all comparisons compare numbers both as signed and unsigned 
values. 


The following are valid decimal constants: 


1000 Constant, equal to 1000 or 3E8j¢. 
-32768 Constant, equal to -32768 or 8000j¢. 
20 Constant, equal to 25, or 1916. 


Hexadecimal Integer Constants 


A hexadecimal integer constant is written as a string of up to four hexa- 
decimal numerals preceded by a greater than (>) sign. Hexadecimal nume- 
rals include the decimal valves 0 through 9 and the letters A through F. 


The following are Valid hexadecimal constants: 


>78 Constant, equal to 120,or 781¢. 
>F Constant, equal to 15, or Fy¢. 
>37 AC Constant, equal to 14252 or 37ACj¢. 


Character Constants 


A character constant is written as a string of one or two characters en- 
closed in single quotes. For each single quote required within a charac- 
ter constant, two consecutive single quotes are required to represent the 
quote, The characters are represented internally as eight-bit ASCII cha- 
racters, with the leading bit set to zero. A character constant consisting 
only of two single quotes (no character) is valid, and is assigned the 
value 0000 4. 


The following are valid character constants: 


"AB' Represented internally as 4142),. 
*C’ Represented internally as 0043144. 
"N' Represented internally as 004E1¢. 
ee p* Represented internally as 274416. 


Assembly-Time Constants 


An assembly-time constant is written as an expression in the operand 
field of an EQU directive, described in a subsequent paragraph. The 
value of the label is determined at assembly time, and is considered 

to be absolute or relocatable according to the relocatability of the ex- 
pression, not according to the relocatability of the location counter 
value, 


Zeek 
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The following are examples of valid expressions: 
BLUE+1 The sum of the value of symbol BLUE plus 1, 
GREEN-4 The result of subtracting 4 from the value of symbol GREEN, 


2*16+RED The sum of the value of symbol RED plus the product of 
2 times 16, 


440/2-RED The result of dividing 440 by 2 and subtracting the 
value of symbol RED from the quotient. RED must be ab- 
solute, 


Well-Defined Expressions 


Some assembler directives require well-defined expressions in the ope- 
rand fields, For an expression to be well-defined, any symbols or as- 
sembly-time constants in the expression must have been previously defined, 
Also, the evaluation of a well-defined expression must be absolute, and 

a well-defined expression may not contain a character constant, 


Arithmetic Operators 


The arithmetic operators in expressions are as follows: 
e + for addition 

e - for subtraction 

e * for multiplication 

e / for signed division 

e //for logical right shift 


In evaluating an expression, the assembler first negates any constant or 

symbol preceded by a unary minus, then performs the arithmetic operations 
from left to right. The assembler does not assign precedence to any ope- 

ration other than unary minus, All operations are integer operations. 

The assembler truncates the fraction in division, 


For example, the expression 4+5*2 would be evaluated 18, not 14, and the 
expression 7+1/2 would be evaluated 4, not 7. 


The logical right shift operator (//) allows a logical division by a 
power of two. 


Examples: 
>8000//1 = >4000 >AAAB//1 = >5555 
>FFFF//O = >FFFF >FFFF//16= >0000 


SDSMAC checks for overflow conditions when arithmetic operations are 
performed at assembly time and gives a warning message whenever an over- 
flow occurs, or when the sign of the result is not as expected in respect 
to the operands and the operation performed, Examples where a VALUE 
TRUNCATED message is given are: 


>4000*2 >7FFF+1  -1*>8000 
>8000*2 >8000-1 -2*>8001 


Constants 


Constants are used in expressions. The assembler recognizes four types of 
constants: decimal integer constants, hexadecimal integer constants, cha- 
racter constants, and assembly-time constants. 
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Operand Field 


The operand field begins following the blank that terminates the opera- 
tion field, and may not extend past character position 60 of the source 
record, The operand field may contain one or more expressions, terms, or 
constants, according to the requirements of the opcode. The operand field 
is terminated by one or more blanks. 


Comment Field 


The comment field begins following the blank that terminates the operand 
field, and may extend to the end of the source record if required, The 
comment field may contain any ASCII character, including blank, The con- 
tents of the comment field are listed in the source portion of the as- 
sembly listing and have no other effect on the assembly, 


Expressions 


Expressions are used in the operand fields of assembler directives and 
machine instructions, An expression is a constant or symbol, or a series 
of constants, a series of symbols, or a series of constants and symbols 
separated by arithmetic operators. Each constant or symbol may be pre- 
ceded by a minus sign (unary minus). An expression may contain no em- 
bedded blanks, or symbols that are defined as extended operations, Ex- 
ternal referenced are allowed only within certain limits (refer to pa- 
ragraph 6.3.13). An expression may contain more than one symbol that is 
not previously defined. When these symbols are absolute, they may also 
be operands of multiplication or division operations within an expression, 
Generally, an expression that contains a relocatable symbol or reloca- 
table constant immediately following a multiplication or division ope- 
rator is an illegal expression. Also, when the result of evaluating an 
expression up to a multiplication or division operator is relocatable, 
the expression is illegal. An expression in which the number of reloca- 
table symbols or constants added to the expression exceeds the number of 
relocatable symbols or constants subtracted from the expression by more 
than one is an illegal expression. 


If NA = Number of relocatable values added and 
NS = Number of relocatable values subtracted and 
Then if 


O The expression is absolute 
NA - NS = 41 The expression is relocatable 
| Other than O or 1, the expression is illegal 


An expression containing relocatable symbols or constants of several dif- 
ferent relocation types (see Section 8) is absolute if it is absolute 
with respect to all relocation types. If it is relocatable with respect 
to one relocation type and absolute with respect to all other relocation 
types, then the expression is relocatable. For example, the expression 


RED + BLUE - GREEN + 2 


is progrom-relocatable if BLUE is a program-relocatable symbol and the 
symbols RED and GREEN are both data-relocatable, If the symbols RED, BLUE, 
and GREEN were program-relocatable, data-relocatable, and common-reloca- 
table, respectively, the expression would be invalid. 
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Source Statement Formats 


Figure 2-7, 


1630/Ass/0281/e 


2.761 


Lah ot 


2.7.3 


2/11 


Figure 2-7 shows source statements written on a coding form illustrating 
alternative methods of entering statements. The first four statements 
illustrate the alignment of the label, opcode, operands, and comments 

to begin in the same column in each statement. This method promotes 
readability, but may be time-consuming on some input devices, particu- 
larly data terminals. The last four statements show the use of horizon- 
tal tab characters represented by r to separate the fields. 


Character Set 


The assembler for the TA 1630 Computer recognizes ASCII characters as 
follows: 


e The alphabet (capital letters only) and space character 
e The numerals 
e Twenty two special characters 


e Five characters defined for this language, that are undefined as 
ASCII characters 


e The null character 
e The tab character 


Appendix A contains tables that list all 66 characters and show the ASCII 
and Hollerith codes for each, 


Label Field 


The label field begins in character position one of the source record 

and extends to the first blank. The label field contains a symbol con- 
taining up to six characters the first of which must be alphabetic, Ad- 
ditional characters may be any alphanumeric characters. A label is op- 
tional for machine instructions and for many assembler directives. When 
the label is omitted, the first character position must contain a blank. 
A source statement consisting of only a label field is a valid statement; 
it has the effect of assigning the current location to the label. This 

is usually equivalent to placing the label in the label field of the fol- 
lowing machine instruction or assembler directive, However, when a state- 
ment consisting of a label only follows a TEXT or BYTE directive and is 
followed by a DATA directive or a machine instruction, the label will 

not have the value of a label in the following statement unless the TEXT 
or BYTE directive counter on an even (word) location, An EVEN directive 
following the TEXT or BYTE directive prevents this problem, 


Operation Field 


The operation (opcode) field begins following the blank that terminates 
the label field, or in the first non-blank character position after the 
first character position when the label is omitted. The operation field 
is terminated by one or more blanks, and may not extend past character 
position 60 of the source record, The.operation field contains an opcode, 
one of the following: 


e@ Mnemonic operation code of a machine instruction 
e Assembler directive operation code 
e Symbol assigned to an extended operation by a DXOP directive 


e Pseudo-instruction operation code 
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2.6 Privileged Mode 


The TA 1630 Computer has a privileged mode in which any instruction of 
the instruction set may be executed. When the computer is not in the 
privileged mode, and execution of a privileged instruction is attempted, 
the instruction is not executed and an error interrupt occurs. The pri- 
vileged instructions perform operating system functions not appropriate 
in user programs, The specific instructions are identified in a subse- 
quent section. The computer is placed in the privileged mode and the 
map file set to map file O when power is applied, when an interrupt oc- 
curs, and when an XOP instruction is executed, 


2.7 Source Statement Format 


An assembly language source program consists of source statements which 
may contain assembler directives, machine instructions, pseudo-instruc- 
tions, or comments, Each source statement is a source record as defined 
for the source medium; i.,e., a line of characters terminated by a car- 

riage return for input from the keyboard of a terminal, such as the DTS, 


The following conventions apply in the syntax definitions for machine 
instructions and assembler directives: 


e Items in capital letters, and special characters, must be entered as 
shown, 


e Items within angle brackets (<>) are defined by the user. 

e Items in lower case letters are classes (generic names) of items. 

e Items within brackets ([]) are optional. 

e Items within braces (} }) are alternative items; one must be entered. 
e An ellipsis (...) indicates that the preceding item may be repeated. 
e The symbol b represents a blank or space. 


The syntax for source statements other than comment statements is defined 
as follows: 


[<label>]}b...opcodeb... [<operand>][,<operand>]...6...[<comment>] 


The syntax definition means that a source statement may have a label, 
which is defined by the user, One or more blanks separate the label from 
the opcode. Mnemonic operation codes, assembler directives codes, and 
user-defined operation codes are all included in the generic term op- 
code, and any of these may be entered. One or more blanks separate the 
opcode from the operand, when an operand is required, Additional operands, 
when required, are separated by commas. One or more blanks separate the 
operand or operands from the comment field, 


Comment statements consist of a single field starting with an asterisk 
(*) in the first character position followed by any ASCII character 
including a blank in each succeeding character position. Comment state- 
ments are listed in the source portion of the assembly listing and have 
no other effect on the assembly, 


The maximum length of source records is 60 characters, The last source 
statement of a source program is followed by the end-of-record statement 
for the source medium i.e., for disk files, an end of file record. 
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When power is applied, the status register clears, selecting map file 0 
and the limit and bias registers are set to zero. The Map Enable bit 
(bit 4 at CRU base address 1FA016) is also reset so addresses are not 
mapped, The Map Enable bit must be set to one to cause mapping to occur. 
When the mapping is enabled and all the map file registers are zero, the 
limits (one's complement of limit register contents) are FFFF 1g. This 
results in all addresses using bias register 1, which contains zero. 

The result is that all addresses are mapped into the same addresses, 

Map file 1 consists of three limit registers and three bias registers, 
and is intended for application programs. Map file 2 similarly consists 
of three limit registers, and three bias registers, and is used to map 
one specified address outside of the current map. The LMF instruction 
loads may files O and 1. 


For example, figure 2-6 shows a map file and the comparison of processor 
addresses to limits, Figure 2-6 also shows the addition of a bias regi- 
ster to a processor address, The contents of the map file are chosen in 
this example so that processor addresses 000014 through 10FF1¢ map to 
addresses 00000014 through OOIOFFy,, processor addresses 110016 through 
AOFF 14 map to addresses 0322E01,¢ through O3B2DF1¢, and processor addres- 
ses A100), through F7FF16 map to addresses 04A10016 through O4F7FF 16. 
Processor addresses greater than F7FFj¢ result in error interrupts. This 
requires that limit register L1 contains 111011110005, the one's comple- 
ment of the 11 most significant bits of 10FFj¢. Similarly, limit regi- 
ster L2 contains 010111110002 (one's complement of 11 most significant 
bits of AOFF 16) and limit register L3 contains 00001000000 (one's com- 
plement of the 11 most significant bits of F7FFj¢). Bias register Bl 
contains 000016, bias register B2 contains 188Fj,¢, and bias register B3 
contains 20001¢. 


MAP FILE 
9 10 11 1213 14 15 


oo 2 3 4 5 6 7 8 


COMPARISON RESULT 
o 1 2 3 4 8§ 6 7 8 9 10141 12 13 14 15 


PROCESSOR 
ADDRESS perey en ers ree ert ks 


1 ' 1 ' 1 ' ' ' 
ui DOoooooonoo onearEn Tuan 
o 123 4 85 6 7 8 ¥Y 160 11 12 1314 15 
PROCESSOR 
reer: EECRoDConkELAESS 
ee ee ee ee ee 
o V2 8 @ &,¢ 97. 8 8 16 1% t2 ta.34 415 
! 
! 


! 
! 
' 
= BULLE 
' 
' 
' 
' 
' 
' 


yy ' 14 ' 1 _ 
' ' ! ' ' 1 ! i ' 
> Se ftp em Red 
tot ' 'ot i 1 to 


1 1 oe 
; iol 
‘es © 4 
ee 
23 4 5 6 7 8 98 10 11 12 13 14 15 16 17 18 19 


MEMORY 
ee Ono oRnnooeoS 


Figure 2-6, Address Development TA 1630 Mapping 


' ' 
‘ ' 
' ' 
' ' 

o #1 


1630/Ass/0281/e 


3.29 


3/35 


Definition: 
Add the signed displacement in the instruction word to the PC and re- 
place the PC with the sum, 


Status bits affected: None 


Oo 1 2s3s3sé4 83 6 7 868 @ 10 1 1213 14 15 
/ 

INTERRUPT 

haf aataele [ever] fen er 1 MB we 


Execution results: (PC) + Displacement — (PC) 


The PC is incremented to the address of the next instruction prior to 
execution of an instruction. The execution results of jump instructions 
refer to the PC contents after the contents have been incremented to 
address the next instruction in sequence. The displacement (in words) 
is shifted to the left one bit position to orient the word displace- 
ment to the word address and added to the PC contents. 


Application notes: 
Use the JMP instruction to transfer control to another section of the 
program module. 


Jump If Logical High JH 
Op Code: 1B00 


Addressing mode: Format II 


Format: 


o 1 2 3,4 5 6 748 9 10 11j12 13 1415 

LEED ET eee 
Syntax definition: 

[<label>]b...JHb...<exp>b... [<comment>] 
Example: 


LABEL JH CONT IF L> AND NOT EQ SKIP TO CONT 


Definition: 
When the equal status bit is reset and the logical greater than status 
bit is set, add the signed displacement in the instruction word to the 
contents of the PC and replace the PC with the sum. 
Status bits tested: 

O31. 'L2 TS. 54 35 


o 1 2 S £2 BAG FF 1S: 
Vj 
INTERRUPT 


Jump if: L>= 1 and EQ = 0 


Status bits affected: None 
10 11 12 13 14 15 


oF 2s £8 6 7 GS 
/ 
L>| A> ov INTERRUPT 
/| MASK 
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Execution results: 
If logical greater than bit is equal to 1 and equal bit is equal to 0: 
(PC) + Displacement (PC). 


If logical greater than bit is equal to 0 or equal bit is equal to 1: 
(PC) + (PC). 


Refer to explanation of execution in paragraph 3.28, 


Application notes: 
Use the JH instruction to transfer control when the equal status bit 
is reset and the logical status bit is set. 


Jump If Logical Low JL 
Op Code: 1A00 


Addressing mode: Format II 


Format: 

o 1 2 3;4 5 6 7,8 9 10 11)12 1314 15 

fefef els] fe} fe] eemnceumer | 
Syntax definition: 

[<label>]®...JLb6...<exp>to... [<comment>] 
Example: 


LABEL JL PREVLB IF L>AND EQ ARE LOW, JUMP TO PREVLB 


Definition: 

When the equal and logical greater than status bits are reset, add the 
Signed displacement in the instruction word to the PC contents and re- 
place the PC with the sum. 


Status bits tested: 


°o 1 2 3 4 5 6 7 8 98 10 11 12 13 14 15 
Y pr 
> INTERRU 
LOLA ov y, MASK 


A 


Jump if: L>= 0 and EQ = 0 
Status bits affected: None 


1) 1 2 3 4 §$ 6 2? 8 9 10 T1 12 13 14 15 
/ INTERRUPT 
Lo} A> Cc }OVv i MASK 


Execution results: 
If logical greater than bit and equal bit are equal to 0: 
(PC) + Displacement — (PC). 


If logical greater than bit is equal to 1 or equal bit is equal to 1: 
(PC) — (PC). 
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Refer to explanation of execution in paragraph 3.28. 


Application notes: 
Use the JL instruction to transfer control when the equal and logical 
greater than status bits are reset. 


Jump If High Or Equal JHE 
Op Code: 1400 


Addressing mode: Format II 
Format: 


oO 1 2 3) 4 3:.6..7) 8 9 10 13,t2 13 34 15 


Syntax definition: 
[<label>]b...JHEb...<exp>b... [<comment >] 
Example: 
LABEL JHE LABEL LOOP HERE UNTIL EQ AND L>ARE RESET 


Definition: 

When the equal status bit or the logical greater than status bit is set 
add the signed displacement in the instruction word to the PC and re- 
place the contents of the PC with the sum. 


’ 


Status bits tested: 
0 9 10 11 12 1314 15 


1 23 45 67 8B 
/ 
INTERRUPT 
tfe>]eo] clover] = fom me l/////] es 


“a 


Jump if: L>= 1 or EQ = 1 
Status bits affected: None 


o 1 2 3 #4 5S 6 7 8 9 4011 1213.14.18 
77 
INTERRUPT 
roles ¢ levfor] x |eebel////// MASK 


Execution results: 
If logical greater than bit is equal to 1 or equal bit is equal to 1: 
(PC) + Displacement — (PC). 


If logical greater than bit and equal bit are equal to 0: (PC) ~ (PC). 
Refer to explanation of execution in paragraph 3,28. 


Application notes: 
Use the JHE instruction to transfer control when either the logical 
greater than or equal status bit is set. 
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3.32 Jump If Low Or Equal JLE 
Op Code: 1200 


Addressing mode: Format II 


Format: 
o 1 2 3,4 5S 6 7, 8 9 10 11,12 13 14 15 
sfefelfe]=| |e] mmscommer | 
Syntax definition: 
[<label>]b...JLEb...<exp>b...[<comment>] 
Example: 


LABEL JLE THERE JUMP TO THERE WHEN EQ=1 or L>=0 


Definition: 

When the equal status bit is set or the logical greater than status 
bit is reset, add the signed displacement in the instruction word to 
the contents of the PC and replace the PC with the sum. 


NOTE 
JLE is not jump if less than or equal. 
Status bits tested: 


6 9 10 11 12 1314 15 


SSRESCGoS///GT ae 


Jump if: L>=0 or EQ = 
Status bits affected: None 


9 10 11 1213 14 15 


SSO OS eS /// Gr oae 


Execution results: 
If logical greater than bit is equal to 0 or equal bit is equal to 1: 
(PC) + Displacement — (PC). 


If logical greater than bit is equal to 1 and equal bit is equal to 0: 
(PC) + (PC). 


Refer to explanation of execution in paragraph 3.28, 


Application notes: 
Use the JLE instruction to transfer control when the equal status bit 
is set or the logical greater than status bit is reset. 
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3.33 Jump If Greater Than JGT 


Op Code: 1500 


Addressing mode: Format II 


Format: 


9 10 141412 13 14 15 


Syntax definition: 


[<label>]...JGTb...<exp>b... [<comment >] 


Example: 
LABEL JGT 


Definition: 


THERE JUMP TO THERE IF A>=1 


When the arithmetic greater than status bit is set, add the signed 
displacement in the instruction word to the PC and place the sum in 
the PC. Transfer control to the new PC location, 


Status bits tested: 


9 10 11 121314 15 


SCOOSSRSS /// Eo 


Jump if: A>=1 


Status bits affected: None 


9 10 11 42 13-14 135 


Sse 


Execution results: 


If arithmetic greater than bit is equal to 1: (PC) + Displacement — (PC). 
If arithmetic greater than bit is equal to 0: (PC) — (PC). 


Refer to explanation of execution in paragraph 3.28. 


Application notes: 
status bit is set. 


Transfers control if the arithmetic greater than 
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3.34 Jump If Less Than JLT 
Op Code: 1100 


Addressing mode: Format II 


Format: 

o 1 2 344 5S 6 7,8 9 10 11412 13 14 15 

SOBSSCCO mene 
Syntax definition: 

[<label>] b...JLTb...<exp>b... [<comment>] 
Example: 


LABEL JLT THERE JUMP TO THERE IF A>=0 AND EQ=0 


Definition: 

When the equal and arithmetic greater than status bits are reset, add 
the signed displacement in the instruction word to the PC and replace 
the PC contents with the sum. 


Status bits tested: 


8 9 10 11 12 13 1415 


SSCoCSOS 


Jump if: A>=0 and EQ=0 
Status bits affected: None 


5 8 9 10 11 121314 15 
y/] INTERRUPT 
A> ov MASK 


Execution results: 
If arithmetic greater than bit and equal bit are equal to 0: 
(PC) + Displacement — (PC). 


If arithmetic greater than bit is equal to 1 or equal bit is equal to 1: 
(PC) ~ (PC). 


Refer to explanation of execution in paragraph 3.28, 


Application notes: 
Use the JLT instruction to transfer control when the equal and arith- 
metic greater than status bits are reset. 
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3.35 Jump If Equal  JEQ 
Op Code: 1300 


Addressing mode: Format II 


Format: 
oO 1 2 3;4 5 6 748 9 10 1141213 1415 
popaps| a] off] 4]. Samomumr  - 
Syntax definition: 
[<label>]b...JEQb...<exp>b... [<comment>] 
Example: 


LABEL JEQ LOC JUMP TO LOC IF EQ=1 


Definition: 

When the equal status bit is set, transfer control by adding the signed 
displacement in the instruction word to the program counter and then 
place the sum in the PC to transfer control. 


Status bits tested: 


o 1 2 3 4-8 6 7 B. OutO U1 F298. 14. 15 
Yj y, 
INTERRUPT 


Jump if: EQ=1 
Status bits affected: None 


oe 7 "Ee" 3 4 5 6-7: 6 “S TO "HT T2°t3' 14 33 
W 
INTERRUPT 
tf leo| © fovfor] x fenlme///// a 


Execution results: 
If equal bit is equal to 1: (PC) + Displacement — (PC). 


If equal bit is equal to 0: (PC) — (PC). 
Refer to explanation of execution in paragraph 3.28. 


Application notes: 
Use the JEQ instruction to transfer control when the equal status bit 
is set and to test CRU bits. 


3.36 Jump If Not Equal  JNE 
Op Code: 1600 


Addressing mode: Format II 


Format: 


Or +8y 22 SG 5S OS 7 6. 910. 28 )02 13.14 15 
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Syntax definition: 

[<label>] b...JNEb...<exp>b... [<comment>] 
Example: 

LABEL JNE LOC2 JUMP TO LOC2 IF EQ=0 


Definition: 
When the equal status bit is reset, add the signed displacement in 
the instruction word to the PC and replace the PC with the sum. 


Status bits tested: 


9 10 11 12 13 14 15 


SCOSSSO RSE 


Jump if: EQ=0 
Status bits affected: None 


8 9 10 11 1213 14 15 


SS cao // eee 


Execution results: 
If equal bit is equal to 0: (PC) + Displacement — (PC). 


If equal bit is equal to 1: (PC) — (PC). 
Refer to explanation of execution in paragraph 3.28. 


Application notes: 
Use the JNE instruction to transfer control when the equal status bit 
is reset. The JNE instruction is also useful in testing CRU bits. 


3.37 Jump On Carry JOC 
Op Code: 1800 


Addressing mode: Format II 


Format: 
o 1 2 3;4 5S 6 7;8 9 1011412 13 1415 
efoto fs fof ole] ssrscemenr | 
Syntax definition: 
[<label>] b...JOCb...<exp>b... [<comment>] 
Example: 


LABEL JOC PROCED IF C=1 SKIP TO PROCED 


Definition: 
When the carry status bit is set, add the signed displacement in the 
instruction word to the PC and replace the PC with the sum. 
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Status bits tested: 


o 1 2 a A. B 6.7% 8B 9 ..10.31.12. 13.14 15 
i/ i] 

MASK 

A 

fe 


Jump if: C= 1 
Status bits affected: None 


o 12 3 4 5 6 7 8 9 1011 12 1314 15 
//Y¥ /Y 
L>|A> ov // INTERRUPT 
} MASK 


Execution results: 
If carry bit is equal to 1: (PC) + Displacement — (PC). 


If carry bit is equal to 0: (PC) — (PC). 
Refer to explanation of execution in paragraph 3.28. 


Application notes: 
Use the JOC instruction to transfer control when the carry status bit 
is set. 


Jump If No Carry  JNC 
Op Code: 1700 


Addressing mode: Format II 


Format: 


1) 1 2 3 }.4...3. 8° 2 8 9 10 11,1213 1415 

PEED TEE ee 
Syntax definition: 

[klabel>] b...JNCb...<exp>b... [<comment>] 
Example: 


LABEL JNC NONE JUMP TO NONE IF C=0 


Definition: 
When the carry status bit is reset, add the signed displacement in the 
instruction word to the PC and replace the PC with the sum. 


Status bits tested: 


9 10 111213 14 15 


GO # 2.48.4 8-87 & 
L>la> aa / INTERRUPT 
/) MASK 


Jump if: C=0 
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Status bits affected: None 


o 1 2 83 4 8 6 7 § 9 10 1% 42 $3 14 15 
/ 
INTERRUPT 
s>fa>lee|« fov for] fre |r , Bec 


Execution results: 
If carry bit is equal to 0: (PC) + Displacement — (PC). 


If carry bit is equal to 1: (PC) + (PC). 
Refer to explanation of execution in paragraph 3.28. 


Application notes: 
Use the JNC instruction to transfer control when the carry status bit 


is reset. 
3.39 Jump If No Overflow JNO 
Op Code: 1900 


Addressing mode: Format II 


Format: 


Oo 1 2 3;4 5 6 774 8 9 10 11,12 13 1415 


Syntax definition: 
[<labe1>] b...JNOb...<exp>b... [<comment >] 
Example: 


LABEL JNO NORML JUMP TO NORML IF OV=0 


Definition: 
When the overflow status bit is reset, add the signed displacement in 
the instruction word to the PC and replace the PC with the sum. 


Status bits tested: 


te) 1 23 4 5 6 7 8 9 190 11 12 13 14 15 
/ 
L>|A> Ov INTERRUPT 
/| MASK 


Jump if: OV =0 
Status bits affected: None 


o 1 2 3 4 5 6 7 B 9 10 11 12 13 14 15 
/ 

L>]A> ov MF INTERRUPT 
A MASK 


Execution results: 
If overflow bit is equal to 0: (PC) + Displacement — (PC). 


If overflow bit is equal to 1: (PC) — (PC). 


Refer to explanation of execution in paragraph 3.28. 
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Application notes: 

Use the JNO instruction to transfer control when the overflow status 
bit is reset. JNO normally transfers control during arithmetic 
sequences where addition, subtraction, incrementing, and decrementing 
may cause an overflow condition. JNO may also be used following an 
SLA (Shift Left Arithmetic) operation. If, during the SLA execution, 
the sign of the workspace register being shifted changes (+ to -, 

- to +), the overflow status bit sets. This feature permits transfer, 
after a sign change, to error correction routines or to another 
functional code sequence. 


Jump If Odd Parity JOP 
Op Code: 1C00 


Addressing mode: Format II 


Format: 

o 1 2 374 8 6 7,8 9 10 19)12-13 14 18 

SCocoocome ae 
Syntax definition: 

[<label>]b...JOPb...<exp>b... [<comment >] 
Example: 


LABEL JOP THERE JUMP TO THERE IF OP=1 


Definition: 
When the odd parity status bit is set, add the signed displacement in 
the instruction word to the PC and replace the PC with the sum. 


Status bits tested: 


Ook 120-8: ees 6 7 Be 10 1 he TE-44 45 
Vj 
> INTERRUPT 
tae je fovfor xen ee////// MASK 


Jump if: OP = 1] 
Status bits affected: None 


o 1 2.3 BOS Ss F B.S LONI 12 13) 148 
L>|A> Ov x Y INTERRUPT 
/ MASK 


Execution results: 
If odd parity bit is equal to 1: (PC) + Displacement — (PC). 


If odd parity bit is equal to O: (PC) — (PC). 


Refer to explanation of execution in paragraph 3.28. 


3.41 


3/46 


Application notes: 

Use the JOP instruction to transfer control when there is odd parity. 
Odd parity indicates that there is an odd number of logic one bits in 
the byte tested. JOP transfers control if the byte tested contains an 
odd number (sum) of logic one bits. This instruction may be used in 
data transmissions where the parity of the transmitted byte is used 
to ensure the validity of the received character at the point of re- 
ception. 


Execute _X 
Op Code: 0480 
Addressing mode: Format VI 


Format: 
0 1 2 3,4 8S 6 7) 8 9 10 11,12 13 14 15 
ele] efole] eff ffs | s | 
Syntax definition: 


<label>]6...Xb...<ga.>b... [<comment> 
s 


Example: 
LABEL X 2 EXECUTE THE CONTENTS OF WSR2 


Definition: 

Execute the source operand as an instruction. When the source operand 
is not a single word instruction, the word or words following the 
execute instruction are used with the source operand as a 2-word or 
3-word instruction. The source operand, when executed as an instruc- 
tion, may affect the contents of the status register. The PC incre- 
ments by either one, two, or three words depending upon the source 
operand. If the executed instruction is a branch, the branch is taken. 
If the executed instruction is a jump and if the conditions for a 
jump (i.e. the status test indicates a jump) are satisfied, then the 
jump is taken relative to the location of the X instruction. 


Status bits affected: 
None, but substituted instruction affects status bits normally, 


ie) 10 11 12 13 14 18 


1 2 3 4 5 6 7 68 9 
/ 
L>|A> ov / ia 0 ed 


Execution results: 
An instruction at ga, is executed instead of the X instruction. 


Application notes: 

Use the X instruction to execute the source operand as an instruction. 
This is primarily useful when the instruction to be executed is de- 
pendent upon a variable factor. Refer to a subsequent paragraph for 
additional application notes. 
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3.42 Compare Instructions 


Compare instructions have no effect other than the setting or re- 
setting of appropriate status bits in the status register. The com- 
pare instructions perform both arithmetic and logical comparisons. 
The arithmetic comparison is of the two operands as two's comple- 
ment values and the logical comparison is of the two operands as 
unsigned magnitude values. The instructions are: 


Instruction Mnemonic Paragraph 
Compare Words G 3.43 
Compare Bytes CB 3.44 
Compare Immediate CI 3.45 
Compare Ones Corresponding COC 3.46 
Compare Zeros Corresponding CZC 3.47 


3.43 Compare Words  C 
Op Code: 8000 


Addressing mode: Format I 


o #6 2 3,4 5 6 7,8 9 10 11,12 13 14 15 


Syntax definition: 


Format: 


[<label>]b...Cb.. .<ga>,<gag>b... [<comment>] 
Example: 


LABEL C 2,3 COMPARE THE CONTENTS OF WSR2 AND WSR3 


Definition: 

Compare the source operand (word) with the destination operand (word) 
and set/reset the status bits to indicate the results of the compa- 
rison, The arithmetic and equal comparisons compare the operand as 
Signed, two's complement values. The logical comparison compares the 
two operands as unsigned, 16-bit magnitude values. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


° 4 5 8 9 10 11 1213 14 15 


1 2 3 6 7 
SSOOS Sos ///as 


A 


Execution results: (ga,) : (gay) 


Application notes: 
C compares the two operands as signed, two's complement values and as 
unsigned integers. Some examples are: 
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Source Destination Logical Arithmetic Equal 
FFFF 0000 1 0 0 
7FFF 0000 1 1 0 
8000 0000 1 0 0 
8000 7FFF 1 0 0 
7FFF 7FFF 0 0 1 
7FFF 8000 0 ] 0 


3.44 Compare Bytes CB 
Op Code: 9000 
Addressing mode: Format I 
Format: 
o.1 2 °3,4 5 6 74,8 9 40 11412 13 1415 
BECO ee ee Ee ee 
Syntax definition: 
[<label>] b...CBb.. .<ga>,<gay>b...[<comment>] 


Example: 


LABEL CB 2,3 COMPARE THE LEFTMOST BYTES OF WSR2 AND 
WSR3 


Definition: 

Compare the source operand (byte) with the destination operand (byte) 
and set/reset the status bits according to the result of the compari- 
son. CB uses the same comparison basis as does C. If the source ope- 
rand contains an odd number of logic one bits, the odd parity status 
bit sets. The operands remain unchanged. If either operand is addressed 
in the workspace register mode, the byte addressed is the most signi- 
ficant byte. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and odd parity. 


9 10 11 1213 14 15 


SELLE 


Execution results: (ga) : (gay) 
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Application notes: 
CB compares the two operands as signed, two's complement values or as 
unsigned integers. Some examples are: 


Source Destination Logical Arithmetic Equal Odd Parity 


FF 00 1 0 0 0 
7F 00 1 1 0 1 
80 00 1 0 0 1 
80 7F 1 0 0 1 
7F 7F 0 0 1 1 
7F 80 0) 1 0 1 


Compare Immediate CI 
Op Code: 0280 


Addressing mode: Format VIII 


Format: 


9 10 11412 13 14 15 


Syntax definition: 

[<label>]b...CIb...<wa>,<iop>b...[<comment>] 
Example: 

LABEL. ..CI.«3, .7 COMPARE CONTENTS OF WSR3 TO 7 
Definition: 
Compare the contents of the specified workspace register with the word 
in memory immediately following the instruction. Set/reset the status 


bits according to the comparison. CI makes the same type of comparison 
as does C, 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


S10. 1 L245 14 33 


ESSOR SOS 


Execution results: (wa) : iop 


Application notes: 

Use the CI instruction to compare the workspace register to an imme- 
diate operand. For example, if the contents of workspace register 9 
is 2183)¢, then the instruction 


CI 9 ,>F 330 


results in the arithmetic greater than status bit set and the logical 
greater than and equal status bits reset. 
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3.46 Compare Ones Corresponding COC 


Op Code: 2000 
Addressing mode: Format III 


Format: 


Syntax definition: 
[<label>]b...COCb...<gag>,<wag>b... [<comment>] 
Example: 


LABEL COC ()MASK, 2 DOES (WSR2) SATISFY MASK? 


Definition: 

When the bits in the destination operand workspace register that 
correspond to the logic one bits in the source operand are equal 
to logic one, set the equal status bit. The source and destination 
operands are unchanged. 


Status bits affected: Equal 


o 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
/ 

L>|A> ov MF INTERRUPT 
A MASK 


Execution results: 
Equal bit set if all bits of (wag) that correspond to the bits of 
(ga,) that are equal to 1 are also equal to 1. 


Application notes: 

Use the COC instruction to test single/multiple bits within a word 
in a workspace register. For example, if TESTBI contains the word 
C102;¢ and workspace register 8 contains the value E306;¢, then the 
instruction 


Coc (@ TESTBI,8 


results in setting the equal status bit. If workspace register 8 were 
to contain E301 6" then equal status bit would reset. Use this in- 
struction to determine if a workspace register has 1s in the bit po- 
sitions indicated by 1s in a mask. 


3.47 Compare Zeros Corresponding CZC 


Op Code: 2400 
Addressing mode: Format III 


Format: 


6 7,8 9 10 11/12 1314 18° 


° 1 2 3,4 38 
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Syntax definition: 
[<label>]...CZCb...<gag>,<wag>b...[<comment>] 
Example: 
LABEL CZC (@MASK, 2 DOES (WSR2) SATISFY THE MASK? 


Definition: 

When the bits in the destination operand workspace register that cor- 
respond to the one bits in the source operand are all equal to a logic 
zero, set the equal status bit. The source and destination operands 
are unchanged. 


Status bits affected: Equal 


9 10 11 1213 1415 


SSCeScee 2 


Execution results: 
Equal bit set if all bits of (wag) that correspond to the bits of (ga,) 
that are equal to 1 are equal to 0. 


Application notes: 

Use the CZC instruction to test single/multiple bits within a word in 
a workspace register. For example, if the memory location labeled 
TESTBI contains the value C102) ¢, and workspace register 8 contains 
230116, then the instruction 


CZC (@ TESTBI, 8 


results in the equal status bit reset. If workspace register 8 con- 
tained the value 2201;¢, then the equal status bit would set. Use 
this instruction to determine if a workspace register has Os in the 
positions indicated by Os in a mask. 


Control And CRU Instructions 


Control instructions affect the operation of the Arithmetic Unit (AU) 

and the associated portions of the computer. CRU instructions affect 

the modules connected to the Communications Register Unit. The instructions 
are: 


Instruction Mnemonic Paragraph 
Clock Off CKOF 3,51 
Clock On CKON 3.52 
Load CRU LDCR tog 
Idle IDLE 3.50 
Load or Restart Execution LREX 3.53 
Reset RSET 3.49 
Set CRU Bit to Logic One SBO 3.54 
Set CRU Bit to Logic Zero SBZ 3.55 
Store CRU STCR 3.58 
Test Bit TB 3.56 
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3.49 Reset RSET 
Op Code: 0360 
Addressing mode: Format VII 


Format: 


9 10 11412 13 14 15 


Syntax definition: 
[<label>]...RSETb... [<comment>] 
Example: 
LABEL RSET START OVER 


Definition: 

The RSET instruction clears the interrupt mask, which disables all 
except level 0 interrupts. It also resets all directly connected in- 
put/output devices and those CRU devices that provide for reset in 
the interface with the CRU. RSET also resets all pending interrupts 
and turns the clock off. 


When Privileged Mode bit (bit 7 of ST register) is set to 0, instruc- 
tion executes normally. When Privileged Mode bit is set to 1, an error 
interrupt occurs when execution of an RSET instruction is attempted. 


Status bits affected: None 


7 8 9 10 11 12173 14 15 


Sqaoeeea 2/1: 


Execution results: 

Clears the interrupt mask, resets directly connected I/O devices, 
resets the CRU devices that provide for reset in the interface with 
the CRU, resets pending interrupts, and turns the clock off. 


Application notes: 

Use the reset instruction to reset the interrupt mask to zero, turn 
off the clock, and (depending on the device and interface) clear any 
pending interrupt and reset interface electronics. 
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3.50 Idle IDLE 
Op Code: 0340 
Addressing mode: Format VII 


Format: 


S 6 7) 8 9 10 1131213 1415 


Syntax definition: 
[<label>] b... IDLE... [<comment>] 
Example: 


LABEL IDLE WAIT FOR INTERRUPT 


Definition: 

Place the computer in the idle state. Note that the PC is incremented 
prior to the execution of this instruction and the contents of the PC 
point to the instruction word in memory immediately following the 
IDLE instruction. The computer will remain in the IDLE state until 

an interrupt, RESTART, or LOAD occurs. 


When Privileged Mode bit (bit 7 of ST register) is set to 0,instruction 
executes normally. When Privileged Mode bit is set to 1, an error inter- 
rupt occurs when execution of an IDLE instruction is attempted. 


Status bits affected: None 


9 10 111213 14 15 


SS 10 aa 


Execution results: 
Places the computer in the idle mode, suspending program execution 
until an interrupt occurs. 


Application notes: 

Use the IDLE instruction to place the computer in the idle state. 
This instruction is useful in timing delays using the clock or in 
waiting for interrupt signals. 
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3.52 
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Clock Off CKOF 


Op Code: 03C0O 
Addressing mode: Format VII 


Format: 


0 AUB “EE 9 10 as 13 1415 
Syntax definition: 

[<label>] b...CKOFb... [<comment>] 
Example: 


STOCK CKOF STOP THE CLOCK 


Definition: 
Stop the line frequency clock (120 Hz). No status bits are changed and 
the clock interrupt will not occur as long as the clock is off. 


When Privileged Mode bit (bit 7 of ST register) is set to 0, instruc- 
tion executes normally. When Privileged Mode bit is set to 1, an 
error interrupt occurs when execution of a CKOF instruction is attempted. 


Status bits affected: None 


BSB 8 10 11% 12.139 14 15 


Execution results: 
Line frequency clock disabled, and the clock interrupt cleared. 


Application notes: 

Clock applications are described in paragraph 3.89.7.2. 
Clock On CKON 

Op Code: O3A0 

Addressing mode: Format VII 


Format: 


eek ane 9 10 AR 1314 15 


Syntax definition: 
[<label>]b...CKONb... [ecomment>] 
Example: 
STRTC CKON START THE CLOCK 
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Definition: 

Enable the line frequency clock. If interrupt level five is enabled, 
an interrupt will occur every 8.33 ms after the initial interrupt, 
which may occur from lus to 8.33 ms after the clock is turned on. 
Interrupt five may be enabled/disabled by the interrupt mask as ne- 


cessary. 


When Privileged Mode bit (bit 7 of ST register) is set to 0, instruc- 
tion executes normally. When Privileged Mode bit is set to 1, an error 
interrupt occurs when execution of a CKON instruction is attempted. 


Status bits affected: None 


10 11 12 1314 15 


4 7 
SEGgoaoas Ga 


Execution results: 
Line frequency clock enabled. 


Application notes: 

Clock applications are described in paragraph 3.89.7.2. 
Load Or Restart Execution _LREX 

Op Code: O3E0 

Addressing mode: Format VII 

Format: 


9 10 #1412 13 14 15 


Syntax definition: 
[<label>]b...LREXb... [<comment>] 
Example: 
LABEL LREX START ALL OVER 


Definition: 

Place the contents of location FFFC;¢ into the WP register and the 
contents of location FFFE,, into the PC, Store the previous contents 
of the WP register, the PC, and the ST register into workspace regi- 
sters 13, 14, and 15, respectively. Set the interrupt mask to 0, 
disabling all interrupt levels except level 0. 
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The LREX instruction sets the Privileged Mode bit (bit 7) of the ST 
register to 0 in addition to performing the context switch. When the 
Privileged Mode bit is set to O prior to execution of an LREX instruc- 
tion, the instruction executes normally. When the Privileged Mode bit 
is set to 1 and execution of an LREX instruction is attempted, an 
error interrupt occurs. In addition the LREX instruction sets the Map 
File bit (bit 8) of the ST register to 0. 


Status bits affected: 
Map File, Privilege, Interrupt Mask 


8 9 10 11 1213 14 15 


SESOSE0o 2/5 


Execution results: (location FFFC;¢) — (WP) 

(location FFFE;¢) — (PC) 

(old WP) ~ (Workspace register 13) 

(old PC) + (Workspace register 14) 

(old ST) + (Workspace register 15) 

0 — (Interrupt Mask) 

O — (Map File) | Status Register 

0 — (Privilege) 
Application notes: 
Use the LREX instruction to perform a context switch using the transfer 
vector at location FFFC,,. Typically, the transfer vector transfers 
control to the front panel routine in Read Only Memory (ROM). Additional 
application information is included in a subsequent paragraph. 


3.54 Set CRU Bit To Logic One SBO 
Op Code: 1D00 


Addressing mode: Format II 


Format: 
1°) 1 2 3; 4 5 6 7,8 9 10 11,12 13 14 15 
SOSERERS Me 
Syntax definition: 
[<label>] b...SBOb...<disp>b...[<comment>] 


Example: 
LABEL SBO 7 SET BIT 7 ON CRU TO ONE 
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Definition: 

Set the digital output bit to a logic one on the CRU at the address 
derived from this instruction. The derived address is the sum of the 
user supplied signed displacement and the contents of workspace re- 
gister 12, bits 3 through 14. The execution of this instruction does 
not affect the status register or the contents of workspace register 12. 


When the Privileged Mode bit (bit 7) of the ST register is set to 0, 
the SBO instruction executes normally. When bit 7 is set to 1 and the 
effective CRU address is equal to or greater than E001¢, an error 
interrupt occurs and the instruction is not executed. 


Status bits affected: None 


o 1 2 3 4 5 6 7 86 9 10 111213 14 15 
/} MASK 


Execution results: 
CRU bit addressed by the sum of the contents of workspace register 
12 + displacement is set to 1. 


Application notes: 
Use the SBO instruction to set a CRU bit to a logic one. Refer toa 
subsequent paragraph for additional application notes. 


Set CRU Bit To Logic Zero SBZ 
Op Code: 1£00 


Addressing mode: Format II 


Format: 
oO. & 2 304,68 6-22 RO {6-13.512 13 14 15 
pas BI ae ide oo 
Syntax definition: 
[<label>]b...SBZb...<disp>b... [kcomment>] 
Example: 


LABEL SBZ 7 SET BIT 7 ON CRU TO ZERO 


Definition: 

Set the digital output bit to a logic zero on the CRU at the address 
derived from this instruction. The derived address is the sum of the 
user supplied signed displacement and the contents of workspace re- 
gister 12, bits 3 through 14. The execution of this instruction does 
not affect the status register or the contents of workspace register 12. 


When the Privileged Mode bit (bit 7) of the ST register is set to 0, 
the SBZ instruction executes normally. When bit 7 is set to 1 and the 
effective CRU address is equal to or greater than E0016, an error 
interrupt occurs and the instruction is not executed. 
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Status bits affected: None 


9 70 11 12°13 14 15 
SSCS e s/s aia 


Execution results: 
CRU bit addressed by the sum of the contents of workspace register 12 
(bits 3-14) + displacement is set to 0. 


Application notes: 

Use the SBZ instruction to set a CRU bit to a logic zero. Refer toa 
subsequent paragraph for additional application notes. 

Test Bit 1B 

Op Code: 1F00 

Addressing mode: Format II 


Format: 


o 1 2314 5 6 7,8 9 10 11,12 13 14 15 
Syntax definition: 


[<label>] b...TBb...<disp>b... [<comment>] 


Example: 
CHECK TB 7 READ BIT 7 ON CRU AND SET EQUAL STATUS 
BIT WITH THE VALUE READ 
Definition: 


Read the digital input bit on the CRU at the address specified by the 
sum of the user supplied signed displacement and the contents of work- 
space register 12, bits 3 through 14 and set the equal status bit to 
the logic value read. The digital input bit and the contents of work- 
Space register 12 are unchanged. 


When the Privileged Mode bit (bit 7) of the ST register is set to 0, 
the TB instruction executes normally. When bit 7 is set to 1 and the 
effective CRU address is equal to or greater than E00, ¢, an error 
interrupt occurs and the instruction is not executed. 


Status bits affected: Equal 


10 14 Te 1314 15 


SSSASeOS2///05o 


Execution results: 
Equal bit is set to the value of the CRU bit addressed by the sum of 
the contents of workspace register 12 (bits 3-12) + displacement. 
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Application notes: 

TB CRU line logic level test transfers the logic level from the indi- 
cated CRU line to the equal status bit without modification. If the 
CRU line tested is set to a logic one, the equal status bit sets to 

a logic one and if the line is zero, sets to a zero. JEQ will then 
transfer control when the CRU line is a logic one and will not trans- 
fer control when the line is a logic zero. In addition, JNE will 
transfer control under the exact opposite conditions. 


Load CRU_LDCR 
Op Code: 3000 
Addressing mode: Format IV 


Format: 

i!) 1 2 3494 5S 6 748 9 10 14141213 1415 

BORG Os eee eee 
Syntax definition: 

[Klabel>] b...LDCRb...<ga,>, <cnt>b... [<comment>] 
Example: 


WRITE LDCR (@)BUFF, 15 SEND 15 BITS FROM BUFF TO CRU 


Definition: 

Transfer the number of bits specified in the C field from the source 
operand to the CRU, The transfer begins with the least significant bit 
of the source operand. The CRU address is contained in bits 3 through 
14 of workspace register 12. When the C field contains zero, the num- 
ber of bits transferred is 16. If the number of bits to be transferred 
is from one to eight, the source operand address is a byte address. If 
the number of bits to be transferred is from 9 to 16, the source ope- 
rand address is a word address. If the source operand address is odd, 
the address is truncated to an even address prior to data transfer. 
When the number of bits transferred is a byte or less, the source ope- 
rand is compared to zero and the status bits are set/reset, according 
to the results of the comparison. The odd parity status bit sets when 
the bits in a byte (or less) to be transferred establish odd parity. 


When the Privileged Mode bit (bit 7) of the ST register is set to 0, 
the LDCR instruction executes normally. When bit 7 is set to 1 and the 
effective CRU address is equal to or greater than E00) ¢, an error in- 
terrupt occurs and the instruction is not executed. 


Status bits affected: 

Logical greater than, arithmetic greater than, and equal. When C is 
less than 9, odd parity is also set or reset. Status is set according 
to the full word or byte, not just the transferred bits. 


ae 4 5 6 9 10.11 12 13 14 15 


2 3 7 8 
belee| = loor] = [eee ////] irae | 
‘A 
A 
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Execution results: 
Number of bits specified by C are transferred from memory at address 


_ ga, to consecutive CRU lines beginning at the address in workspace 


register 12. 


Application notes: 

Use the LDCR instruction to transfer a specific number of bits from 
memory to the CRU at the address contained in bits 3 through 14 of 
workspace register 12. Refer to a subsequent paragraph for a detailed 
example and explanation of the LDCR instruction. 

Store CRU _STCR 

Op Code: 3400 

Addressing mode: Format IV 


Format: 


o 1 2 3,4 5 6 7,8 9 10 11;12 1314 15 
Syntax definition: 


[<label>] b...STCRb...<gag>,<cnt>b... [<comment >] 


Example: 
READ STCR (@ BUF, 9 READ 9 BITS FROM CRU AND STORE AT 
LOCATION BUF 
Definition: 


Transfer the number of bits specified in the C field from the CRU to 
the source operand. The transfer begins from the CRU address specified 
in bits 3 through 14 of workspace register 12 to the least significant 
bit of the source operand and fills the source operand toward the 

most significant bit. When the C field contains a zero, the number of 
bits to transfer is 16. If the number of bits to transfer is from one 
to eight, the source operand address is a byte address. Any bit in the 
memory byte not filled by the transfer is reset to a zero. When the 
number of bits to transfer is from 9 to 16, the source operand address 
is a word address. If the source operand address is odd, the address 
is truncated to an even address prior to data transfer. If the transfer 
does not fill the entire memory word, unfilled bits are reset to zero. 
When the number of bits to transfer is a byte or less, the bits trans- 
ferred are compared to zero and the status bits set/reset to indicate 
the results of the comparison. Also, when the bits to be transferred 
are a byte or less, the odd parity bit sets when the bits establish 
odd parity. 


When the Privileged Mode bit (bit 7) of the ST register is set to 0, 
the STCR instruction executes normally. When bit 7 is set to 1 and 
the effective CRU address is equal to or greater than E004, an error 
interrupt occurs and the instruction is not executed. 
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Status bits affected: 

Logical greater than, arithmetic greater than, and equal. When C is 
less than 9, odd parity is also set or reset. Status is set according 
to the full word or byte, not just those bits transferred. 


9 10 11 1213 14 15 


Execution results: 

Number of bits specified by C are transferred from consecutive CRU 
lines beginning at the address in workspace register 12 to memory at 
address gag. 


Application notes: 

Use the STCR instruction to transfer a specified number of CRU bits 
from the CRU to memory location supplied by the user as the source 
operand. Note that the CRU base address must be in workspace regi- 
ster 12 prior to the execution of this instruction. Refer to a sub- 
sequent paragraph for a detailed explanation and examples of the use 
of the STCR instruction. 


Load And Move Instructions 


Load and move instructions permit the user to establish the execution 
environment and the execution results. These instructions manipulate 
data between memory locations and between hardware registers and me- 
mory locations. The instructions are: 


Instruction Mnemonic Paragraph 
Load Immediate LI 3.60 
Load Interrupt Mask Immediate LIMI 3.61 
Load Memory Map File LMF 3.63 
Load Workspace Pointer 

Immediate LWPI 3.62 
Move Words MOV 3.64 
Move Bytes MOVB 3.65 
Store Status STST 3.67 
Store Workspace Pointer STWP 3.68 
Swap Bytes SWPB 3.66 


Load Immediate LI 


Op Code: 0200 
Addressing mode; Format VIII 


Format: 


Tek ABE 9 ne 13:14 15 


3.61 


3/62 


Syntax definition: 
[<label>] b...LIb...<wa>,<iop>b... [<comment>] 
Example: 


GETIT LI 3,>17 LOAD WSR3 WITH 17HEX=23 


Definition: 

Place the immediate operand (the word of memory immediately following 
the instruction) in the user specified workspace register (W field). 
The immediate operand is not affected by the execution of this in- 
struction. The immediate operand is compared to 0 and the L.A. and 
EQ status bits are set or reset according to the result of the compa- 
rison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


9 10 11 12 1314 15 


ssggsooas GE 


Execution results: iop — (wa) 


Application notes: 

Use the LI instruction to place an immediate operand in a specified 
workspace register. This is useful for initializing a workspace regi- 
ster as a loop counter. For example, the instruction 


LE 7,0 


initializes workspace register 7 with the value 00051, . L>and A> 
are set while EQ is reset in this example. 


Load Interrupt Mask Immediate _LIMI 
Op Code: 0300 


Addressing mode: Format VIII 


Format: 


S VO 34 sie 18. 24.195 


Syntax definition: 

[<label>]®...LIMIb...<iop>b... [<comment>] 
Example: 

LABEL LIMI 3 MASK LEVEL 3 AND BELOW 
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Definition: 

Place the low order four bits (bits 12-15) of the contents of the 
immediate operand (the next word after the instruction) in the inter- 
rupt mask of the status register. The remaining bits of the status 
register (0 through 11) are not affected. 


When Privileged Mode bit (bit 7 of ST register) is set to 0, instruc- 
tion executes normally. When Privileged Mode bit is set to 1, an error 
interrupt occurs when execution of an LIMI instruction is attempted 
and the interrupt mask is not loaded. 


Status bits affected: Interrupt Mask 


0 1 2 3 4 § 6 7 B 9 10 11 1213 14 15 
77) 
INTERRUPT 
42AAA 


Execution results: 
Places the four least significant bits of iop into the interrupt mask, 
the four least significant bits of the ST register. 


Application notes: 
Use the LIMI instruction to initialize the interrupt mask for a parti- 
cular level of interrupt to be accepted. For example, the instruction 


LIMI 3 
sets the interrupt mask to level three and enables interrupts at level 
Orth? 25 and ‘35 


Load Workspace Pointer Immediate _LWPI 
Op Code: O02E0 


Addressing mode: Format VIII 


Format: 


Oo § 2 274 6 § 7 6 9 10 1412 13 1415 


Syntax definition: 

[<label>] ...LWPIb...<iop>b... [<comment>] 
Example: 

NEWWP LWPI O2F2 O2F 2=NEWWP 


Definition: 
Replace the contents of the WP with the immediate operand. The immediate 
operand is the word of memory immediately following the LWPI instruction. 


Status bits affected: None 


9 10 11 12 13 14 15 


0 1 2 3 4 5 6 = 8 
/ 
SSSeSe0S2 Gra 


3.63 


3/64 


Execution results: iop — (WP) 


Application notes: 

Use the LWPI instruction to initialize or change the WP register to 
alter the workspace environment of the program module. The user 
should use either a BLWP or a LWPI instruction prior to the use of 
any workspace register in a program module. 


Load Memory Map File LMF 
Op Code: 0320 
Addressing mode: Format IX 


Format: 
seine Hike 9 10 si 1314 15 


Syntax definition: 
[<label>]b...LMFb...<wa>,<m>b... [<comment>] 
Example: 
NMAP LMF 3,1 LOAD MAP FILE 1 


Definition: 

Place the contents of a six-word area of memory at the address in the 
workspace register specified by wa into the memory map file designated 
by m. 


Status bits affected: None 


7 8@8 © 4OUl 12 135 4 18 


CEE EE 


Execution results: 
When Privileged Mode bit (bit 7 of ST register) is set to 0: the con- 
tents of a six-word area at address in wa are placed in map file m. 


When Privileged Mode bit is set to 1, an error interrupt occurs. 


Application notes: 

Use the LMF instruction to load either map file 0 or 1 (map file 2 
is loaded by the long distance instructions). The map file is a set 
of six registers that maps the 32K word addresses of the AU into the 
desired addresses of memory having a larger capacity. The six-word 
area contains the following: 
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(A)132204 


Words 0, 2, and 4 contain values that are placed in limit registers 
L1, L2, and L3. 


To determine values to be placed in the limit registers, the following 
considerations apply: 


e@ The 11 most significant bits of each memory word are placed in the 
11-bit limit registers. 


e The 5 least significant bits may be any value. (They are ignored) 


e@ The one's complement of the limit is placed in the memory word, and 
in the map file. 


The values in word 1, 3, and 5 are the 16 most significant bits of the 
bias register values, and are placed in registers Bl, B2, and B3. 


To determine the values to be placed in the six-word memory area, con- 
sider the following: 


e All addresses from 0 through limit 1 are contiguous in memory. 


e All addresses greater than limit 1, up through limit 2 are contiguous 
in memory. 


All addresses greater than limit 2, up through limit 3 are contiguous 
in memory. 


e All addresses greater than limit 3 are protected addresses. 


Place the one's complements of the limit values in words 0, 2, and 4. 


e Place the 16 most significant bits of the bias address for the 


lowest group in the second word. 


e Place the 16 most significant bits of the bias address for the next 


group in the fourth word. 


e Place the 16 most significant bits of the bias address for the 


highest group in the sixth word. 
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3.64 Move Word MOV 
Op Code: C000 
Addressing mode: Format I 


Format: 


9 10 114912 13 14 15 


Syntax definition: 

[Klabel>]b... MOVb...<ga>,<gay>b... [<comment>] 
Example: 

GET MOV G)WORD,2 GET A COPY OF WORD INTO WSR2 


Definition: 

Replace the destination operand with a copy of the source operand. The 
AU compares the resulting destination operand to zero and sets/resets 
the status bits according to the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


16 1f 2 t3 14 5 


SSO SG a /// GE 


Execution results: (gag) — (gay) 


Application notes: 
MOV is used to move 16-bit words as follows: 


Memory-to-memory (non register) 
Load register (memory-to-register) 
Register-to-register 
Register-to-memory 


MOV may also be used to compare a memory location to zero by the use of 


MOV 7,7 
JNE TEST 


which would move register 7 to itself and compare the contents of re- 
gister 7 to zero. If the contents are not equal to zero, the equal 
status bit is reset and control transfers to TEST. Another use of MOV, 
for example, is if workspace register 9 contains 3416), and location 
ONES contains FFFFy¢, then 


MOV (@ ONES,9 


changes the contents of workspace register 9 to FFFF16, while the con- 
tents of location ONES is not changed. For this example, the logical 
greater than status bit sets and the arithmetic greater than and equal 
status bits reset. 
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Move Byte _ MOVB 
Op Code: DOOO 


Addressing mode: Format I 


Format: 


Syntax definition: 


[<label>] b.. .MOVb...<ga.>,<gag>b... [<comment>] 


Example: 
NEXT MOVB 2, (BUFF (3) STORE CHARACTER IN EFFECTIVE BUFFER 
ADDRESS 
Definition: 


Replace the destination operand (byte) with a copy of the source ope- 
rand (byte). If either operand is addressed in the workspace register 
mode, the byte addressed is the most significant byte of the word 
(bits 0-7) and the least significant byte (bits 8-15) is not affected 
by this instruction, The AU compares the destination operand to zero 
and sets/resets the status bits to indicate the result of the compari- 
son. The odd parity bit sets when the bits in the destination operand 
establish odd parity. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and odd parity. 


o 1 8 9 1011 12 1314 15 


> Sh. 8 6 F 
y/ INTERRUPT 
L>|A> c jov pf frets, 


Execution results: (ga,) — (gay) 


Application notes: 

MOVB is used to move bytes in the same combinations as the MOV instruc- 
tion moves words. For example, if memory location 1C141¢ contains a 
value of 2016), and TEMP is located at 1C15}¢, and if workspace regi- 
ster 3 contains 542B),¢, then the instruction 


MOVB (@ TEMP, 3 


changes the contents of workspace register 3 to 162B,¢. The logical 
greater than, arithmetic greater than, and odd parity status bits set 
while the equal status bit resets. 


3.66 


3.67 
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Swap Bytes _SWPB 
Op Code: 06CO 


Addressing mode: Format VI 


Format: 


9 10 %4;12 13 14 185 


Syntax definition: 

[Klabel>] b...SWPBb...<ga.>b... [<comment>] 
Example: 

SWITCH SWPB 3 BYTE REVERSE WSR3 


Definition: 

Replace the most significant byte (bits 0-7) of the source operand 
with a copy of the least significant byte (bits 8-15) of the source 
operand and replace the least significant byte with a copy of the 
most significant byte. 


Status bits affected: None 


10 44 U2 Asta. 15 


7 


Execution results: 
Exchanges left and right bytes of word (ga,). 


Application notes: 

Use the SWPB instruction to interchange bytes of an operand prior to 
executing various byte instructions. For example, if workspace register 
O contains 2144,, and memory location 2144,¢ contains the value F312)¢, 
then the instruction 


SWPB = *O+ 


changes the contents of workspace register 0 to 21461 and the contents 
of memory location 2144,¢ to 12F3)¢. The status register remains un- 
changed. 


Store Status STST 


Op Code: 02C0 
Addressing mode: Format VIII 


Format: 


9 10 1141213 1415 
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Syntax definition: 
[<label>]b...STSTb...<wa>b...[<comment >] 
Example: 
LABEL STST 7 STORE STATUS IN WSR7 


Definition: 
Store the status register contents in the specified workspace register. 


Status bits affected: None 


o 46. 14 2 13) 14 18 


Sooo /// Ge 


Execution results: (ST) — (wa) 


Application notes: 
Use the STST instruction to store the ST register contents when appli- 
cable, 


Store Workspace Pointer STWP 
Op Code: 02A0 


Addressing mode: Format VIII 


Format: 
S 10 A100 42 443 14 tS 


Syntax definition: 

[<label>] b...STWPb...<wa>b... [<comment >] 
Example: 

LABEL STWP 6 STORE WKSP POINTER IN WSR6 


Definition: 
Place a copy of the workspace pointer contents in the specified work- 
space register. 


Status bits affected: None 


10 14°42 19:14 18 


SEDoSa0S2// Ea 


Execution results: (WP) — (wa) 


Application notes: 
Use the STWP instruction to store the contents of the WP register as 
applicable. 
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3.69 Logical Instructions 


The set of logical instructions permits the user to perform various lo- 
gical operations on memory locations and/or workspace registers. The 
instructions are: 


Instruction Mnemonic Paragraph 
AND Immediate ANDI 3.70 
Clear CLR 3.74 
Invert INV 3.73 
OR Immediate ORI 3.71 
Set to One SETO 3.75 
Set Ones Corresponding (OR) SOC 3.76 
Set Ones Corresponding Byte 

(OR) SOCB 3.77 
Set Zeros Corresponding SZC 3.78 
Set Zeros Corresponding Byte SZCB 3.79 
Exclusive OR XOR 3.72 


3.70 AND Immediate —_ ANDI 
Op Code: 0240 
Addressing mode: Format VIII 


Format: 


SEEE Foe 9 al 13°14 15 


Syntax definition: 
[klabel>]b...ANDIb...<wa>,<iop>b... [<comment>| 
Example: 
LABEL ANDI 3,>FFFO SET LOWER 4 BITS OF WSR3 TO ZERO 


Definition: 

Perform a bit-by-bit AND operation of the 16 bits in the immediate 
operand and the corresponding bits of the workspace register. The 
immediate operand is the word in memory immediately following the in- 
struction word. Place the result in the workspace register. The AU 
compares the result to zero and sets/resets the status bits according 
to the results of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


8 9 10 11 1213 14 15 


SSO SSS /// G2 


Execution results: (wa) AND iop — (wa) 


1630/Ass/0281/e 


3.71 


3/71 


Application notes: 

Use the ANDI instruction to perform a logical AND with an immediate 
operand and a workspace register. Each bit of the 16-bit word of both 
operands follows the truth table 


Immediate Workspace AND 
Operand Bit Register Bit Result 
0 0 0 
0 ] 0 
1 0 0 
1 1 1 


For example, if workspace register 0 contains D2AB, ¢, the instruction 
ANDI 0,>6D03 


results in workspace register 0 changing to 4003, ¢- This AND operation 
on a bit-by-bit basis is 


0110110100000011 (Immediate operand) 
1101001010101011 (Workspace register 0) 
010000000000001 1 (Workspace register 0 result) 


For this example, the logical greater than and arithmetic greater than 
status bits set while the equal status bit resets. ANDI is also useful 
for masking out bits of a workspace register. 


OR Immediate ORI 
Op Code: 0260 
Addressing mode: Format VIII 


Format: 


9 10 1141213 1415 


Syntax definition: 
f<label>]b...ORIb...<wa>,<iop>b... [<comment>] 


Example: 
LABEL ORI 3,>FO00 SET HIGH ORDER 4 BITS OF WSR3 TO ONES 


Definition: 

Perform an OR operation of the 16-bit immediate operand and the corres- 
ponding bits of the workspace register. The immediate operand is the 
memory word immediately following the ORI instruction. Place the result 
in the workspace register. The AU compares the result to zero and sets/ 
resets the status bits to indicate the result of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


6 9 10 11 12 13 14 15 


SSCB Seg 
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Execution results: (wa) OR iop — (wa) 


Application notes: 

Use the ORI instruction to perform a logical OR with the immediate ope- 
rand and a specified workspace register. Each bit of the 16-bit word 

of both operands is OR'd using the truth table 


Immediate Workspace OR 
Operand Register Result 
0 0 0 
1 0 1 
0 1 1 
1 ] 1 


For example, if workspace register 5 contains D2AB}6, then the instruction 
ORI 5,>6D03 


results in workspace register 5 changing to FFAB, ¢- This OR operation 
on a bit-by-bit basis is 


0110110100000011 (Immediate operand) 
1101001010101011 (Workspace register 5) 
1111111110101011 (Workspace register 5 result) 


For this example, the logical greater than status bit sets, and the 
arithmetic greater than and equal status bits reset. 


Exclusive OR __XOR 

Op Code: 2800 

Addressing mode: Format III 
Format: 


o 1 2. 374 8 6 F 6 9 10 41412 13 1415 


Syntax definition: 


<label>jb...XORb...<ga.>,<wag>b... <comment>| 
s d 


Example: 
LABEL XOR @) WORD, 3 EXCLUSIVE OR THE CONTENTS OF WORD 
AND WSB 
Definition: 


Perform a bit-by-bit exclusive OR of the source and destination operands, 
and replace the destination operand with the result. This exclusive OR 
is accomplished by setting the bits in the resultant destination operand 
to a logic one when the corresponding bits of the two operands are not 
equal. The bits in the resultant destination operand are reset to zero 
when the corresponding bits of the two operands are equal. The AU com- 
pares the resultant destination operand to zero and sets/resets the 
status bits to indicate the result of the comparison. 
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Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


8 9 10 11 12 13 14 15 


SSOOSS002// EOE 


Execution results: (gas) XOR (wag) ~ (wag) 
(i.e. [(gay) AND NOT (way)] OR [(wag) AND NOT (gag)] — (wad) 


Application notes: 

Use the XOR instruction to perform an exclusive OR on two word operands. 
For example, if workspace register 2 contains D2AA;¢ and location CHANGE 
contains the value 6D03; 6, then the instruction 


XOR a CHANGE, 2 


results in the contents of workspace register 2 changing to BFA91¢. 
Location CHANGE remains 6D03;¢. This is shown as 


011011010000001 1 (Source operand) 
1101001010101010 (Destination operand) 
1011111110101001 (Destination operand result) 


For this example, the logical greater than status bit sets while the 
arithmetic greater than and equal status bits reset. 

Invert _ INV 

Op Code: 0540 

Addressing mode: Format VI 


Format: 


9 10.31 st2. (3.1415 


Syntax definition: 
[<label>]6...INVb...<gag>b... [<comment >] 
Example: 


COMPL INV ()BUFF(2) REPLACE BUFFER WORD WITH ONEs 
COMPLEMENT OF DATA 


Definition: 

Replace the source operand with the one's complement of the source ope- 
rand, The one's complement is equivalent to changing each zero in the 
source operand to a logic one and each logic one in the source operand 
to a logic zero. The AU compares the result to zero and sets/resets 

the status bits to indicate the result of the comparison. 
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Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


9 70 11 12 13 14 15 


SSCRSS002///0 


Execution results: 
The one's complement of (ga,) is placed in (ga,). 


Application notes: 

INV changes each logic zero in the source operand to a logic one and 
each logic one to a logic zero. For example, if workspace register 1] 
contains A54B)¢, then the instruction 


INV 11 


changes the contents of workspace register 11 to 5AB4, ¢. The logical 
greater than and arithmetic greater than status bits set and the equal 
status bit resets. 


Clear __CLR 
Op Code: 04C0 
Addressing mode: Format VI 


10 11,12 13 14 15 


Syntax definition: 


[<label>]b...CLRb...<ga,>b... [<comment>] 


Format: 


Example: 
PRELM CLR (a@)BUFF(2) CLEAR EFFECTIVE BUFFER ADDRESS 


Definition: 
Replace the source operand with a full, 16-bit word of zeros. 


Status bits affected: None 


16 U2 V2 TS 14 US 


SCS 


Execution results: 0 — (gas) 


Application notes: 

Use the CLR instruction to set a full, 16-bit, memory addressable word 
to zero. For example, if workspace register 11 contains the value 
200116, then the instruction 


CLR *>B 


results in the contents of memory location 200016 being set to 0. Work- 
space register 11 and the status register are unchanged. 
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3.75 Set To One SETO 


3.76 


Op Code: 0700 
Addressing mode: Format VI 


Format: 


‘BME sR 9 10 ak 13 14 15 


Syntax definition: 
[<label>]b...SETOb...<gag>b... [<comment>] 
Example: 
LABEL SETO 3 SET WSR3 TO -1 


Definition: 
Replace the source operand with a 16-bit word logic one value. 


Status bits affected: None 


8. 9 10 11,-42.13;14_15 


Execution results: FFFFy¢ — (gas) 


Application notes: 
Use the SETO instruction to initialize an addressable memory to a -1 
value. For example, the instruction 


SETO 3 


initializes workspace register 3 to a value of FFFF)¢. The contents of 
the status register is unchanged. This is a useful means of setting 
flag words, 

Set Ones Correspondin SOC 


Op Code: E000 


Addressing mode: Format I 


Format: 


oO 1 2: 3;4 5 6 7,8 9 10 11412 13 1415 
Rik ES ei ae ee 

Syntax definition: 
[<label>]...SOCb...<gag>,<gay>b... [<comment >] 


Example: 
LABEL SOC 3,2 OR WSR3 INTO WSR2 


3.77 
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Definition: 

Set to a logic one the bits in the destination operand that correspond 
to any logic one bit in the source operand. Leave unchanged the bits 
in the destination operand that are in the same bit positions as the 
logic zero bits in the source operand. The changed destination operand 
replaces the original destination operand. This operation is an OR of 
the two operands. The AU compares the result to zero and sets/resets 
the status bits to indicate the result of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


4 5 8 9 10 11 12 13 14 15 


Oo 1 2 3 6 7 
SEOOS EOS G2 


Execution results: 
Bits of (gag) corresponding to bits of (ga,) equal to 1 are set to 1. 


Application notes: 

Use the SOC instruction to OR the 16-bit contents of two operands. For 
example, if workspace register 3 contains FFO0;¢ and location NEW con- 
tains AAAA;6, then the instruction 


SOC 3, (@NEW 


changes the contents of location NEW to FFAA]¢ while the contents of 
workspace register 3 is unchanged. This is shown as 


1111111100000000 (Source operand) 
1010101010101010 (Destination operand) 
1111111110101010 (Destination operand result) 


For this example, the logical greater than status bit sets and the 
arithmetic greater than and equal status bits reset. 


Set Ones Correspondin Byte SOCB 
Op Code: FOOO 


Addressing mode: Format I 
te] ' 2 3, 4 5 
BHnhES 


Syntax definition: 


Format: 


G6 FaB BIO. 10 ste 13 4 ts 


[8 fw) ee | 


[<label>]6...SOCBb...<gas>,<gag>b... [<comment>] 
Example: 


LABEL SOCB 3, @DET OR WSR3 INTO BYTE AT LOCATION DET 
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Definition: 

Set to a logic one the bits in the destination operand byte that cor- 
respond to any logic one in the source operand byte. Leave unchanged 
the bits in the destination operand that are in the same bit positions 
as the logic zero bits in the source operand byte. The changed desti- 
nation operand byte replaces the original destination operand byte. 
This operation is an OR of the two operand bytes. The AU compares the 
resulting destination operand byte to zero and sets/resets the status 
bits to indicate the results of the comparison. The odd parity status 
bit sets when the bits in the resulting byte establish odd parity. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and odd parity. 


o #61 2 6 S30). .3% 12.3444 18 


3 a°*.3- 6 7 
ptt] «foo Fe or ////A ee | 


Execution results: 

Bits of (ga, ) corresponding to bits of (ga,) equal to 1 are set to 1. 
(i.e. (gag) OR (gas) ~ (gag)) 

Application notes: 

Use the SOCB instruction to OR two byte operands. For example, if work- 


space register 5 contains the value F013), and workspace register 8 
contains the value AA24, «, then the instruction 


SOCB C5, 8 


changes the contents of workspace register 8 to FA241¢, while the con- 
tents of workspace register 5 is unchanged. This is shown as 


111100000001001 1 (Source operand) 

1010101000100100 (Destination operand) 

1111101000100100 (Destination operand result) 
(Unchanged) 


For this example, the logical greater than status bit sets while the 
arithmetic greater than, equal, and odd parity status bits reset. 


Set Zeros Correspondin SZC 


Op Code: 4000 


Addressing mode: Format I 


o 1 2 3,4 S 6 748 9 10 414741213 1415 


Syntax definition: 


Format: 


[Flabel=] b...SZCb...<ga,>,<gag>b... [<comment>] 
Example: 


LABEL SZC (q@)MASK, 2 RESET BITS OF WSR2 INDICATED BY MASK 
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Definition: 

Set to a logic zero the bits in the destination operand that correspond 
to the bit positions equal to a logic one in the source operand. This 
operation is effectively an AND operation of the one's complement of 
the source operand and the destination operand. The AU compares the re- 
sulting destination operand to zero and sets/resets the status bits to 
indicate the results of the comparison. 


Status bits affected: 
Logical greater than, arithmetic greater than, and equal. 


8 9 10 11 1213 14 15 


o,f 2 3 «4 8 6 7 
ptt fuer «mo ///A tse 


Execution results: 
Bits of sa corresponding to bits of (gas) equal to 1 are set to 0. 


(i.e. [NOT (gas) AND (gag)] - (gag)) 


Application notes: 

Use the SZC instruction to turn off flag bits or AND the contents of 
the one's complement of the source operand and the destination operand. 
For example, if workspace register 5 contains 6D03} ¢ and workspace re- 
gister 3 contains D2AA;¢, then the instruction 


we 43 


changes the contents of workspace register 3 to 92A8),¢ while the con- 
tents of workspace register 5 remain unchanged. This is shown as 


0110110100000011 (Source operand) 
1101001010101010 (Destination operand) 
1001001010101000 (Destination operand result) 


For this example, the logical greater than status bit sets while the 
arithmetic greater than and equal status bits reset. 


Set Zeros Correspondin Byte SZCB 
Op Code: 5000 


Addressing mode: Format I 


Format: 


Syntax definition: 
[<label>]b...SZCBb...<ga,>,<gag>b... [ecomment>| 
Example: 


LABEL SZCB_ (a)MASK, (CHAR RESET BITS OF CHAR INDICATED 
BY MASK 
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Definition: 

Set to a logic zero the bits in the destination operand byte that cor- 
respond to the bit positions equal to a logic one in the source operand 
byte. This operation is effectively an AND operation of the one's com- 
plement of the source operand byte and the destination operand byte. 
The AU compares the resulting destination operation byte to zero and 
sets/resets the. status bits to indicate the result of the comparison. 
The odd parity status bit sets when the bits in the resulting desti- 
nation operand byte establish odd parity. When the destination operand 
is addressed in the workspace register mode, the least significant byte 


(bits 8-15) is unchanged. 
Status bits affected: 
Logical greater than, arithmetic greater than, equal, and odd parity. 


9 10 11 12 13 1415 


SSCgCogS2///E 


Execution results: 

Bits of (gay) corresponding to bits of (ga, ) equal to 1 are set to 0. 
(ise. [NOT (ga) AND (gag)] - (gag)) 

Application notes: 

The SZCB instruction is used for the same applications as SZC except 
bytes are used instead of words. For example, if location BITS contains 
the value F018)¢, and location TESTVA contains the value AA241¢, then 


SZCB.  (@BITS, (@TESTVA 


changes the contents of TESTVA to 0A24;¢ while BITS remains unchanged. 
This is shown as 


111100000001 1000 (Source operand) 

1010101000100100 (Destination operand) 

0000101000100100 (Destination operand result) 
(Unchanged) 


For this example, the logical greater than and arithmetic greater than 
status bits set while the equal and odd parity status bits reset. 
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3.80 Workspace Register Shift Instructions 
Workspace register shift instructions permit the shifting of the con- 
tents of a specified workspace register from one to sixteen bits. The 
shifting instructions are: 


Instruction Mnemonic Paragraph 
Shift Right Arithmetic SRA 3.81 
Shift Right Logical SRL 3.83 
Shift Left Arithmetic SLA 3.82 
Shift Right Circular SRC 3.84 


For each of these instructions, if the shift count in the instruction 
is zero, the shift count is taken from workspace register 0, bits 12 
through 15. If the four bits of workspace register 0 are equal to 
zero, the shift count is 16 bit positions. The value of the last bit 
shifted out of the workspace register is placed in the carry bit of 
the ST register. The result is compared to zero and the results of 
the comparison are shown in the logical greater than, arithmetic 
greater than, and equal bits (bits 0 through 2) in the ST register. 
If a shift count greater than 15 is supplied, the assembler fills in 
the four-bit field with the least significant four bits of the shift 
count. SDSMAC gives a warning message when this occurs. 


3.81 Shift Right Arithmetic SRA 
Op Code: 0800 


Addressing mode: Format V 


Format: 
ee ; 4 5 6 ‘ 8 9 10 ali 13.14 15 
Syntax definition: 
[<label>]b...SRAb...<wa>,<scnt>b... [<comment>] 
Example: 


LABEL SRA 2,3 SHIFT WSR2 RIGHT THREE BIT LOCATIONS 


Definition: 

Shift the contents of the specified workspace register to the right for 
the specified number of bit positions, filling vacated bit positions 
with the sign bit. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and carry. 


9 10 11 1213 14 15 


SESSe SOE 
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Execution results: 

Shift the bits of (wa) to the right, extending the sign bit to fill 
vacated bit positions. When SCNT is greater than 0, shift the number 
of bit positions specified by SCNT. If SCNT is equal to 0, shift the 
number of bit positions contained in the four least significant bits 
of workspace register 0. When SCNT and the four least significant bits 
of workspace register 0 both contain 0, shift 16 bit positions. 


Application notes: 

An example of an arithmetic right shift is: If workspace register 5 
contains the value 8224,,, and workspace register 0 contains the value 
F3261¢, then the instruction 


SRA 5,0 


changes the contents of workspace register 5 to FE08),¢. The logical 

greater than and carry status bits set while the arithmetic greater 

than and equal status bits reset. Additional examples are shown in a 
subsequent paragraph. 


Shift Left Arithmetic SLA 
Op Code: OAOO 
Addressing mode: Format V 
Format: 
o 1 2 3,4 5 6 7,8 9 1011412 13 1415 
CTTPEEEL Te ] 
Syntax definition: 
[<label>]b...SLAb...<wa>,<scnt>b... [<comment >] 
Example: 
LABEL SLA 2,1 SHIFT WSR2 LEFT ONE BIT LOCATION 
Definition: 
Shift the contents of the specified workspace register to the left 
for the specified number of bit positions while filling the vacated 


bit positions with logic zero values. Note that the overflow status 
bit sets when the sign of the word changes during the shifting operation. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, carry, and over- 


flow. 


9 10 11 42 t3..%4 285 


SOS Grae 
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Execution results: 

Shift the bits of (wa) to the left, filling the vacated bit positions 
with zeros. When SCNT is greater than 0, shift the number of bit posi- 
tions specified by SCNT. If SCNT is equal to 0, shift the number of 
bit positions contained in the four least significant bits of work- 
space register 0. When SCNT and the four least significant bits of 
workspace register 0 both contain 0, shift 16 bit positions. 


Application notes: 
An example of an arithmetic left shift is: If workspace register 10 
contains the value 1357;¢, then the instruction 


SLA 10,5 


changes the contents of workspace register 10 to 6AE0)¢. The logical 
greater than, arithmetic greater than, and overflow status bits set 
while the equal and carry status bits reset. Refer to a subsequent 
paragraph for additional examples. 


Shift Right Logical SRL 
Op Code: 0900 


Addressing mode: Format V 


Format: 
o 1 2 ; 4 5 6 ; 8 9 10 ae 13.1415 
Syntax definition: 
[<label>]b...SRLb...<wa>,<sent>b...[<comment>] 
Example: 


LABEL SRL 3,7 SHIFT WSR3 RIGHT SEVEN BIT LOCATIONS 


Definition: 

Shift the contents of the specified workspace register to the right 
for the specified number of bits while filling the vacated bit posi- 
tions with logic zero values. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and carry. 


9 10 11 12 13 14 15 


0) 1 2 3 4 5 6 7 8 
j>faofee |e fovfor | x fen we/////)] iRREeTT | 
Aaaa ; 


Execution results: 

Shift the bits of (wa) to the right, filling the vacated bit positions 
with zeros. When SCNT is greater than 0, shift the number of bit posi- 
tions specified by SCNT. If SCNT is equal to 0, shift the number of bit 
positions contained in the four least significant bits of workspace 
register 0, When SCNT and the four least significant bits of workspace 
register O both contain 0, shift 16 bit positions. 
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Application notes: 
An example of a logical right shift is: If workspace register zero 
contains the value FFEF;¢, then the instruction 


SRL 0,3 


changes the contents of workspace register 0 to FFD, « The logical 
greater than, arithmetic greater than and carry status bits set while 
the equal status bit resets. Additional examples are shown in a sub- 
sequent paragraph. 


Shift Right Circular SRC 
Op Code: OBOO 


Addressing mode: Format V 


eo J 2 Bi 5 6 ‘1: 9 10 aptae= 


Syntax definition: 


Format: 


[<label>] b...SRCb...<wa>,<scnt>b... [<comment>] 
Example: 
LABEL SRC 7,16-3 SHIFT CIRC WSR7 3 BIT LOCATIONS LEFT 


Definition: 

Shift the specified workspace register to the right for the specified 
number of bit positions while filling vacated bit positions with the 
bit shifted out of position 15. 


Status bits affected: 
Logical greater than, arithmetic greater than, equal, and carry. 


Oo. o61 = S 4 3S) Be. Ze 68 9 10 11 12 13 14 15 
/ 
L>| A> INTERRUPT 


Execution results: 

Shift the bits of (wa) to the right, filling the vacated bit positions 
with the bits shifted out at the right. When SCNT is greater than 0, 
shift the number of bit positions specified by SCNT. If SCNT is equal 
to 0, shift the number of bit positions contained in the four least 
significant bits of workspace register 0. When SCNT and the four least 
significant bits of workspace register O both contain 0, shift 16 bit 
positions. 
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Application notes: 
An example of a circular right shift is: If workspace register 2 con- 
tains the value FFEF,,¢, then the instruction 


SRC 2,7 


changes the contents of workspace register 2 to DFFF,¢. The logical 
greater than and carry status bits set while the Gethin greater 
than and equal status bits reset. Shift left circular is not imple- 
mented since SRC can perform the same function: SLC x,n = SRC x,16-n. 
Refer to a subsequent paragraph for additional application notes. 


3.85 Extended Operation XOP 
Op Code: 2C00 


Addressing mode: Format IX 


Format: 
o 1 2 3,4 5S 6 7,8 9 10 11712 1314 15 
efef feof s} 2 fe] os | 
Syntax definition: 


[klabel>]b...XOPb...<ga,>,<op>b... [<comment >] 


Example: 
LABEL XOP (a)BUFF(4), 12 DO XOP12 ON WORD OF BUFFER SPECIFIED 
BY WSR4 
Definition: 


The op field specifies the extended operation transfer vector in memory. 
The two memory words at that location contain the WP contents and PC 
contents for the software implemented XOP instruction subroutine. The 
memory location for these two words is derived by multiplying the op 
field contents by four and adding the product to 0040;¢. Note that 

the two memory words at this location must contain the necessary WP 

and PC values prior to the XOP instruction execution for software imple- 
mented instructions. 


The effective address of the source operand is placed in workspace re- 
gister 11 of the XOP workspace. The WP contents are placed in work- 
space register 13 of the XOP workspace. The PC contents are placed 

in workspace register 14 of the XOP workspace. The ST contents are 
placed in workspace register 15 of the XOP workspace. Control is 
transferred to the new PC address and the software implemented XOP is 
executed. (XOP execution of software implemented XOP instruction is 
similar to an interrupt trap execution. ) 


An extended operation may be alternatively implemented by user-supp- 

lied hardware. When hardware is connected for the specified opera- 

tion no context switch occurs, and the hardware performs the opera- 

tion. When a TA 1630 Computer performs a software-implemented extended 
operation, the Privileged Mode bit is set to 0. In addition, the Map File 
bit is set to O also. 
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Status bits affected: Extended operation 


° 1 2 3.44.8 6 7 6 @9 10 11 12 139.44515 
y 
fetes] eloronl foe mel/////] se | 
Aaa 


Execution results: ga, ~(workspace register 11) 
(004016 + (op)*4) — (WP) 
(0042, 6.* (op)*4) — (PC) 
(WP) — (workspace register 13) 
(PC) + (workspace register 14) 
(ST) ~ (workspace register 15) 
0 §T8 
0 — ST7 | 990/10 
1 ~ $16 


Application notes: 
Refer to a subsequent paragraph for a detailed example of the execution 
of a software implemented XOP instruction, 


3.86 Long Distance Addressing Instructions 


The long distance addressing instructions enable accesses outside 
of the current memory map for a single address. These instructions 
require the Map Enable bit (bit 4 at CRU base address IFAO, 4) to 
be set to one. The instructions are: 


Instruction Mnemonic Paragraph 
Long Distance Source LDS 3.87 
Long Distance Destination LDD 3.88 


3.87 Long Distance Source LDS 
Op Code: 0780 


Addressing mode: Format VI 


Format: 
© 1 2 3,4 S 6 7,8 9 10 11,12 13 14 15 
efefefefetteLetsfe] = |= | 
Syntax definition: 
[klabel>]6...LDSb.. <ga.>b... [<comment >| 


Example: 


LABEL LDS (@JSIXwD PREPARE TO USE LONG DISTANCE SOURCE 


3.88 
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Definition: 

Place the contents of a six-word area of memory into map file 2, and 
use map file 2 in developing the source address of the next instruc- 
tion. The instruction places the contents of the six-word memory area 
at the effective address of the source operand in map file 2 in all 
cases; the map file is not used when the source address of the follow- 
ing instruction is a workspace register address, or when the following 
instruction is a B, BL, or BLWP instruction. The instruction inhibits 
all interrupts until the following instruction is executed. 


Status bits affected: None 


9 10 11 1213 14 15 


SSCS // Ge 


Execution results: 

When Privileged Mode bit (bit 7 of ST register) is set to 0: The con- 
tents of a six-word area at address ga, are placed in map file 2, and 
the source address of the following instruction is mapped with map 

file 2. (If Ts of the following instruction is equal to 0, or if fol- 
lowing instruction is B, BL, or BLWP instruction, new map is not used.) 


When Privileged Mode bit is set to 1: Error interrupt. 


Application notes: 

Use the LDS instruction in the Privileged Mode to access an address 
outside of the current map. The contents of the six-word area are 
placed in the L1, L2, L3, Bl, B2, and B3 registers of map file 2 as 
shown in paragraph 3.63. The address to which the map file applies 

is the source address of the next instruction. Placing an LDS instruc- 
tion prior to an instruction that has no destination operand, or an 
instruction having a workspace register address for the destination 
operand does not result in an access outside of the current map. 


Long Distance Destination LDD 
Op Code: 07CO 


Addressing mode: Format VI 


Format: 


1 2 3,4 S$ 6 7,6 9 10 BI,t2 13 14 15 


Syntax definition: 
[<label>] 6...LDDb...<ga,>b... [<comment>] 
Example: 
LABEL LDD (a)SIXwWD PREPARE TO STORE LONG DISTANCE 
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Definition: 

Place the contents of a six-word area of memory into map file 2, and 
use map file 2 in developing the destination address of the next in- 
struction. The instruction places the contents of the six-word memory 
area at the effective address of the source operand in map file 2 in 
all cases; the map file is not used when the following instruction 
has no destination operand, or when the destination address has a 
workspace register address. The instruction inhibits all interrupts 
until the following instruction is executed. 


Status bits affected: None 


o 1 2 So 4S 6 JF Oy -Or Oy 2518 44, 15 
/ 

L>|A> Ov INTERRUPT 
A MASK 


Execution results: 

When Privileged Mode bit (bit 7 of ST) is set to 0: the contents of 

a six-word area at address ga, are placed in map file 2, and the de- 
stination address of the following instruction is mapped with map file 2. 
(If Ty of the following instruction is equal to 0, or if the destina- 
tion address is a workspace register address, the new map is not used.) 


When Privileged Mode bit is set to 1: Error interrupt. 


Application notes: 

Use the LDD instruction in the Privileged Mode to access an address 
outside of the current map. The contents of the six-word area are 
placed in the L1, L2, L3, Bl, B2, and B3 registers of map file 2 as 
shown in paragraph 3.63. The address to which the map file applies 

is the destination address of the next instruction. Placing an LDD 
instruction prior to an instruction that has no destination operand, 

or an instruction having a workspace register address for the desti- 
nation operand does not result in an access outside of the current map. 


3.89 Programming Examples 


3.89.1 
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The remaining paragraphs of this section describe programming examples 
that supplement the application notes in the instruction descriptions. 
Programming examples are only included for those instructions for 
which the application notes require additional explanation. 


ABS Instruction 


Since the ABS instruction compares the operand to zero prior to any 
modification of the operand, the ABS instruction may be used to test 
a switch. The following example program illustrates this use of the 
instruction. A word of memory at location SWITCH is used to indicate 
whether or not a subroutine at location SUBR is being executed. Sub- 
routine SUBR is used by several programs, but only one may use it at 
a time. When the subroutine is in use, location SWITCH contains one, 
and other programs may not transfer control to location SUBR. When 
control returns from the subroutine, location SWITCH is set to -1, 
making subroutine SUBR available again. 
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The first instruction would be used in the initialization portion, to 
make the subroutine available initially. The four instructions at lo- 
cation TEST would be included in each program that calls the subrou- 
tine. These instructions branch to location CALL when location SWITCH 
contains -1, setting location SWITCH to +1 after testing its value. 
Any attempt to access the subroutine before its completion results 

in the program entering a delay mode, retesting following each delay 
interval. 


A BL instruction at location CALL transfers control to the subroutine, 
and stores the address of the SETO instruction in workspace register 
11. When the subroutine returns control, the SETO instruction sets lo- 
cation SWITCH to -1, so that the next time any calling program tests 
the location, a transfer to the subroutine occurs. The code is as 
follows. 


SETO —- @SWITCH INITIALIZES SWITCH NEGATIVE! 
TEST ABS @SWITCH TEST SWITCH? 
JLT CALL IF NEGATIVE, TRANSFER? 
XOP @TMDLY,15 IF NOT, WAIT# 
JMP TEST TEST AGAIN 
CALL BL @SUBR USE SUBROUTINE 
SETO —« @SWITCH RESET SWITCHS 
SUBR pe SUBROUTINE ENTRY 
B “11 SUBROUTINE RETURN 
SWITCH DATA 0 STORAGE AREA FOR SWITCH 
TIMDLY DATA —_ > 200,10 TIME DELAY SUPERVISOR 
CALL BLOCK 


NOTE 
1. Set SWITCH to all ones, making it negative. 


2. If SWITCH negative, set to positive value to prevent sub- 
sequent entry. 


Ww 


If value in SWITCH was negative, the JLT instruction 
transfers control. 


Supervisor call pointing to data block defining time delay 
request. Used to wait for a time period before retesting 
SWITCH. While in a time delay, other programs can be exe- 
cuted, thus leaving SUBR available for use. The Time Delay 
Supervisor call is supported by the TAXO Operating System. 
Reference the TA 1630 Supervisor Calls, SCI Command Processor, 
and SCI Interface .Routines. 


5. Upon return, reset SWITCH to negative value to permit future 
use. 
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3.89.2 Shifting Instructions 


3.89.2.1 
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There are 4 shifting instructions available with the TA 1630 Computer 
that permit the user to shift the contents of a specified workspace 
register from one to sixteen consecutive bit positions. 


The four shifting) instructions are: 
e Shift Left Arithmetic (SLA) 

e Shift Right Arithmetic (SRA) 

e Shift Right Circular (SRC) 

e@ Shift Right Logical (SRL) 


Shift Left Arithmetic 


This shifting instruction shifts the indicated workspace register a 
specified number of bits to the left. For example, the instruction 


SLA 5, 1 


would shift the contents of register five one bit to the left. The 
carry status bit contains the value shifted out of bit position zero 
and the jump instructions JOC and JNO permit the user to test the 
shifted bit. The overflow status bit sets when the sign of the con- 
tents of the register being shifted changes during the shift operation. 
If register five contained 


0100111100000111 


before the above instruction, the results of the instruction execution 
would be 


1001111000001110 


and the carry status bit would contain a zero and the overflow status 
bit would set because the contents changed from positive to negative 
(bit zero equal to zero changed to equal to one). If this shift sign 
change is important, the user could insert a JNO instruction to test 
the overflow condition. If there is no overflow, control transfers to 
the normal program sequence. Otherwise, the next instruction is then 
executed. 


It is possible to construct double-length shifts with the SLA instruc- 
tion, which could shift two or more words in a workspace. The follow- 
ing code will shift two consecutive workspace registers. 


e Assumptions: 


1. The contents of workspace registers 1 and 2 are shifted one bit 
position. 


2. Additional code could be included to execute the code once for 
each bit shift required, when shifts of more than one bit posi- 
tion are required. The additional code must include a means of 
testing that the desired number of shifts are performed. 


3. Additional code tests for overflow from workspace register 1, 
to branch to an error routine at location ERR when overflow 
occurs. 


3,89.2.2 


3,.89.2.3 
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e Code 

SLA tt SHIFT W1 ONE BIT 

JOC ERR 

SLA 2,1 SHIFT W2 ONE BIT 

JNC EXIT TRANSFER IF NO CARRY 

INC 1 TRANSFER BIT FROM W2 to W1 
EXIT NOP CONTINUE WITH PROGRAM 
ERR NOP 


Shift Right Arithmetic 


This shifting instruction shifts the contents of a workspace register 
right a specified number of bits and extends the sign bit (bit zero) 

at the logic level that existed prior to the shift. The carry status 

bit contains the last bit shifted out of bit 15 of the workspace re- 

gister. For example, the instruction 


SRA 5,3 


would shift the contents of workspace register five three bits to the 
right. If workspace register five contained 


110000001 1110000 
prior to the shift, the results of this instruction would be 
1111100000011110 


and the carry status bit would contain a logic zero for the last 
shifted bit. 


Shift Right Circular 

The SRC instruction shifts the contents of a workspace register a spe- 
cified number of bits to the right and transfers the bits shifted off 

the right end of the workspace into the left end of the workspace re- 

gister. The carry status bit contains the last bit shifted out of bit 

15 of the workspace register. For example, the instruction 


SRC 6,5 


would shift the contents of register six, five bits to the right and 
transfer the five bits shifted off the right end to the first five bits 
of workspace register six. For this example, if workspace register six 
contained 


1100110011110101 


before this instruction was executed, workspace register six would 
contain 


1010111001100111 


and the carry status bit would contain a logic one from the last bit 
shifted in workspace register six. 
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3.89.2.4 Shift Right Logical 


The SRL instruction shifts the contents of a special workspace register 
to the right for a specified number of bits and fills the vacated bit 
positions on the left end of the workspace with zeros. The carry status 
bit contains the last bit shifted out of bit 15 of the workspace re- 
gister. For example, the instruction 


SRL 5,8 


would shift the contents of workspace register five eight bits to the 
right and would fill the first eight bits of the word with zeros. If 
the workspace register contained 


1000100011111000 


prior to the SRL instruction, the contents of workspace register five 
would be 


000000001 0001000 


and the carry status bit would contain a logic one for the last bit 
shifted off the right end of workspace register five. 


3.89.3 Incrementing And Decrementing 


3.89.3.1 
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There are two decrement and two increment instructions that may be 
used for various types of control when passing through a loop, index- 
ing through an array, or operating within a group of instructions. 


The four incrementing and decrementing instructions available for use 
with the TA 1630 Computer.are: 


e Decrement (DEC) 
e Decrement By Two (DECT) 
e Increment (INC) 
e Increment By Two (INCT). 


The increment and decrement instructions are useful for indexing byte 
arrays and for counting byte operations. The increment and decrement 
by two instructions are useful for indexing word arrays and for count- 
ing word operations. The following paragraphs provide some examples of 
these operations. 


Increment Instruction Example 


Since the INC instruction is useful in byte operations, an example pro- 
blem searches a character array for a character with odd parity. The 
last character contains zero to terminate the search. Begin the search 
at the lowest address of the array and maintain an index in a workspace 
register. The character array for this example is called Al (also the 
relocatable address of the array). The code for a solution to this pro- 
blem is: 


SETO 1 SET COUNTER INDEX TO -1 
SEARCH INC 1 INCREMENT INDEX 

MOVB (@A1(1),2 GET CHARACTER 

JOP ODDP JUMP IF FOUND 

JNE SEARCH CONTINUE SEARCH IF NOT ZERO 
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3.89.3.2 Decrement Instruction Example 


To illustrate the use of a DEC instruction in a byte array, this example 
problem inverts a byte array and places the results in another array of 
the same size. This example inverts a 26-character array called Al and 
places the results in array A2. The contents of Al are defined with a 
data TEXT statement to be as follows: 


Al TEXT "ABCDEFGHIJKLMNOPQRSTUVWXYZ ' 
Array A2 is defined with the BSS statement as follows: 
A2 BSS 26 
The sample code for the solution is: 
LI 5,26 COUNTER AND INDEX FOR Al 
LI 4,A2 ADDRESS OF A2 


INVRT MOVB (@)A1(5),*4+ INVERT ARRAY! 
DEC 5 REDUCE COUNTER 
JGT INVRT CONTINUE IF NOT COMPLETE 


NOTE 

T. @A1(5) addresses elements of array Al in descending order as 
workspace register five is decremented. *4+ addresses array 
A2 in ascending order as workspace register four is incre- 
mented, 


Array A2 would contain the following as a result of executing this se- 
quence of code: 


A2 ZYXWVUTSROQPONMLKJIHGF EDCBA 


Even though the result of this sequence of code is trivial, the example 
use of the MOVB instruction, with indexing by workspace register five, 
and the result incrementally placed into A2 with the auto-increment 
function can be useful in other applications. 


The JGT instruction used to terminate the loop allows workspace regi- 
ster 5 to serve both as a counter and as an index register. 


A special quality of the DEC instruction allows the programmer to si- 
mulate a jump greater than or equal to zero instruction. Since DEC al- 
ways sets the carry status bit except when changing from zero to minus 
one, it can be used in conjunction with a JOC instruction to form a 

JGE loop. The example below performs the same function as the preceding 


example: 
Al TEXT " ABCDEFGHIJKLMNOPQRSTUVWXYZ' 
A2 BSS 26 
LI 5,25 COUNTER AND INDEX FOR Al 
LI 4,A2 ADDRESS OF A2 
INVRT MOVB (@A1(5),*4+ INVERT ARRAY 
DEC 5 REDUCE COUNTER 


JOC INVRT CONTINUE IF NOT COMPLETE 
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NOTE 


Since the use of JOC makes the loop execute when the counter is 
zero, the counter is initialized to 25 rather than 26 as in the 
preceding example. 


3,89.3.3 Decrement By Two Instruction Example 
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To illustrate the use of a DECT instruction in processing word arrays, 
the example problem adds the elements of a word array to the elements 
of another word array and places the results in the second array. The 
contents of the two arrays are initialized as follows: 


Al DATA 500, 300, 800, 1000, 1200, 498, 650, 3, 27,0 
A2 DATA 36,192, 517,29, 315, 807, 290, 40, 130, 1320 


The sample code that adds the two arrays is as follows: 


LI 4,20 INITIALIZE COUNTER 

SUMS A (@A1-2(4), (DA2-2(4) ADD ARRAYS 
DECT 4 DECREMENT COUNTER BY TWO 
JGT SUMS REPEAT ADDITION 


NOTE 
Addressing of the two arrays through the use of the (a) sign 


is indexed by the counter, which is decremented after each 
addition. 


The contents of the A2 array after the addition process is as 
follows: 


A2 536, 492, 1317, 1029, 1515, 1305, 940, 43, 157, 1320 


There is another method by which this addition process may be accom- 
plished. This method is shown in the following code: 


LI 4,10 INITIALIZE COUNTER! 
LI 5,Al-2 LOAD ADDRESS OF A12 
LI 6,A2-2 LOAD ADDRESS OF A22 


SUMS A *54,*6+ ADD ARRAYS 
DEC 4 DECREMENT COUNTER 
JGT SUMS REPEAT ADDITION4 
NOTE 


1. Counter preset to 10 (the number of elements in the array). 


2. This address will be incremented each time an addition takes 
place. The increment is via the auto-increment function (+). 


3. The * indicates that the contents of the register is to be 
used as an address and the + indicates that it will be auto- 
matically incremented by two each time the instruction is 
executed. 


4. Workspace register four will only be greater than zero for 
ten execution of the DEC instruction and control will be 
transferred to SUMS nine times after the initial execution. 


The contents of array A2 are the same for this method as for the first. 


3.89.4 


3.89.4.1 


3,89.4.2 
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Subroutines 


There are two types of subroutine linkage available with the TA 1630 
Computer- One type uses the same set of workspace registers that the 
calling routine uses, and is called a common workspace subroutine. 
The BL instruction stores the contents of the program counter and 
transfers control to the subroutine. Another type is called a con- 
text switch subroutine. The BLWP instruction stores the contents of 
the WP register, the program counter, and the status register. The 
instruction makes the subroutine workspace active and transfers 
control to the subroutine. 


Common Workspace Subroutine Example 


Figure 3-1 shows an example of memory contents prior to a BL call to 

a subroutine. The contents of workspace register 11 is not important 
to the main routine. When the BL instruction is executed, the CPU 
stores the contents of the PC in workspace register 11 of the main 
routine and transfers control to the instruction located at the 
address indicated by the operand of the BL instruction. This type of 
subroutine uses the main program workspace. Figure 3-2 shows the me- 
mory contents after the call to the subroutine with the BL instruction. 


When the instruction at location 1130) 4 is executed (BL @ RAD), the 
present contents of the PC, which point to the next instruction, are 
saved in workspace register 11. WR11 would then contain an address 

of 1134,,. The PC is then loaded with the address of label RAD, which 
is address 2220)¢. This example subroutine returns to the main pro- 
gram with a branch to the address in WR11 (B *11). 


Context Switch Subroutine Example 


Figure 3-3 shows the example memory contents prior to the call to the 
subroutine. The contents of workspace registers 13, 14, and 15 are not 
significant. When the BLWP instruction is executed at location 0300, 
there is a context switch from the main program to the subroutine. The 
context switch then places the main program WP, PC, and ST register 
contents in workspace registers 13, 14, and 15 of the subroutine. This 
saves the environment of the main program for return. The operand of 
the BLWP instruction specifies that the address vector for the context 
switch is in workspace register 5 and 6. The address in workspace re- 
gister 5 is placed in the WP register and the address in workspace re- 
gister 6 is placed in the PC. 


After the instruction at location 0300 is executed, the memory contents 
are shown in figure 3-4, This illustration shows the subroutines in 
control, with the WP pointing to the subroutine workspace and the PC 
pointing to the first instruction of the subroutine. The contents of 
the status register are not reset prior to the execution of the first 
instruction of the subroutine, so the status indicated will actually 

be the status of the main program execution. A subroutine may then 
execute in accordance with the status of the main program. 
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Figure 3-1. Common Workspace Subroutine Example 
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Figure 3-2, PC Contents after BL Instruction Execution 
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Figure 3-3. Context Switch Subroutine Example 
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This example subroutine contains a RTWP return from the subroutine. The 
results of executing the RTWP instruction are shown in figure 3-5. Con- 
trol is transferred to the main program at the instruction following 
the BLWP to the subroutine. The status register is restored from work- 
space register 15 and the workspace pointer points to the workspace 

of the main program. 


When the calling program's workspace contains data for the subroutine, 
this data may be obtained by using the indexed memory address mode in- 
dexed by workspace register 13. The address used is equal to two times 
the number of the workspace register that contains the desired data. 
The following instruction is an example: 


MOV (@10(13),R10 


3/97 
Figure 3-4, After Execution of BLWP Instruction 
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3.89.4.3 Passing Data to Subroutines 
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When a subroutine is entered with a context switch (BLWP) data may be 
passed using either the contents of workspace register 13 or 14 of the 
subroutine workspace. Workspace register 13 contains the memory address 
of the calling program's workspace. The calling program's workspace 

may contain data to be passed to the subroutine. Workspace register 14 
contains the memory address of the next memory location following the 
BLWP instruction. This location and following locations may contain 
data to be passed to the subroutine. 


The contents of workspace register 5 of the calling program's workspace 
(bytes 10 and 11 relative to the workspace address) are placed in work- 
Space register 10 of the subroutine workspace. This method of data 
access by subroutines is appropriate for re-entrant procedures. 
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The following example shows passing of data to a subroutine by placing 
the data following the BLWP instruction: 


SUB 


SUBWS 
SUBPRG 


Figure 3-5. 
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BLWP a SUB SUBROUTINE CALL 

DATA V1 DATA 

DATA v2 DATA 

DATA =-V3 DATA 

JEQ ERROR RETURN FROM SUBROUTINE, TEST 
‘ FOR ERROR (Subroutine sets the 
P EQUAL status bit to one for 

error) 


DATA SUBWS,SUBPRG ENTRY POINT FOR SUB 
AND SUB WRKSPCE 


BSS 32 

MOV *144,1 FETCH V1 PLACED IN WRI 
MOV *144+,2 FETCH V2 PLACED IN WR2 
MOV *144,3 FETCH V3 PLACED IN WR3 
RTWP RETURN FROM SUBROUTINE 
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MEMORY 
ADDRESS 


MEMORY 


T —@ 0100 (WRO) 


| 
| 
| 
| 


lam 


(WRI3)S 


(WRI14)S 


(WRI5)S 


START eece 
e 


e 
SUBROUTINE AREA 


1630/Ass/0281/e 


3.89.5 


3/99 


The three MOV instructions retrieve the variables from the main pro- 


gram module and place them in workspace registers one, two, and three 
of the subroutine. 


When the BLWP instruction is executed, the main program module status 
is stored in workspace register 15 of the subroutine. If the subroutine 
returns with a RTWP instruction, this status is placed in the status 
register after the RTWP instruction is executed. The subroutine may 
alter the status register contents prior to executing the RTWP in- 
struction. The calling program can then test the appropriate bit of 

the status word, the equal bit in this example, with jump instructions. 


A BL instruction can also be used to pass parameters to a subroutine. 
When using this instruction, the originating PC value is placed in 
workspace register 11. Therefore, the subroutine must fetch the pa- 
rameters relative to the contents of workspace register 11 rather 
than the contents of workspace register 14 as in the BLWP example. 
The following example demonstrates parameter passing with a BL in- 
struction: 


BL (a) SUBR BRANCH TO SUBROUTINE 
DATA PARM1,PARM2 PASSED PARAMETERS STORED IN 
NEXT TWO MEMORY WORDS 


JEQ ERROR TEST FOR ERROR (Subroutine sets 
the Equal status bit to one for 
: error) 
SUBR EQU $ 
MOV *R11+,RO GET VALUE OF FIRST PARAMETER 
AND PUT IN WRO 
MOV *R114,R1 GET VALUE OF SECOND PARAMETER 


AND PUT IN WR1 (R11 is incre- 

mented past the locations of the 

two data words and now indicates 

the address of the next instruc- 
° tion in main program) 


B UN 


Interrupts 


Sixteen priority vectored interrupt levels are 

implemented in the TA 1630 Computer. The contents of the 
Interrupt mask in the status register define the interrupt 
level. Low-order memory, address as O through 3F, is reserved 
for transfer vectors used by the interrupts (table 3-4). When 
an interrupt request at an enabled level occurs, the contents 
of the transfer vector corresponding to the level are used to 
enter a subroutine to serve the interrupt. 
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The reserved memory locations are shown on the memory map (figure 2-3). 
Two memory words are reserved for each interrupt level. The first of 
the two words for a given level contains an address that is placed in 
the WP when the interrupt is requested and enabled. The second contains 
the entry point of the interrupt subroutine for that level; its contents 
are placed in the PC. If an executive is in use, it places the transfer 
vectors for pre-defined interrupts and for devices supported by the 
executive in the reserved memory locations. The user need not be con- 
cerned with transfer vectors for interrupts except for programs that 

do not execute under an executive or for external devices not suppor- 
ted by the executive. Similarly, the executive includes interrupt sub- 
routines for pre-defined interrupts and for supported devices. The user 
must supply interrupt subroutines when the executive is not used and 
for devices that are not supported by the executive. 


Table 3-4, Interrupt Vector Addresses 


Memory Interrupt Typical 

Address Vector Vector Contents Assignment 

0000 0 WP address for interrupt 0 Power On 

0002 0 PC address for interrupt 0 

0004 ] WP address for interrupt 1 Power Failing 

0006 1 PC address for interrupt 1 

0008 2 WP address for interrupt 2 Error 

OO0A 2 PC address for interrupt 2 

000C 3 WP address for interrupt 3 External Device 

OOOE 3 PC address for interrupt 3 

0010 4 WP address for interrupt 4 External Device 

0012 4 PC address for interrupt 4 

0014 5 WP address for interrupt 5 External Device or 
Line Frequency Clock 

0016 5 PC address for interrupt 5 

0018 6 WP address for interrupt 6 External Device 

OO1A 6 PC address for interrupt 6 

001C 7 WP address for interrupt 7 External Device 

OO1E 4 PC address for interrupt 7 

0020 8 WP address for interrupt 8 External Device 

0022 8 PC address for interrupt 8 

0024 9 WP address for interrupt 9 External Device 

0026 9 PC address for interrupt 9 


3.89.5.1 
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Table 3-4, Interrupt Vector Addresses (Continued) 


Memory Interrupt 

Address Vector Vector Contents 

0028 10 WP address for interrupt 10 
002A 10 PC address for interrupt 10 
002C 11 WP address for interrupt 11 
002E 11 PC address for interrupt 11 
0030 12 WP address for interrupt 12 
0032 12 PC address for interrupt 12 
0034 13 WP address for interrupt 13 
0036 13 PC address for interrupt 13 
0038 14 WP address for interrupt 14 
003A 14 PC address for interrupt 14 
003C 15 WP address for interrupt 15 
OO3E 15 PC address for interrupt 15 


General Interrupt Structure 


Typical Assignment 


External Device 


External Device 


External Device 


External Device 


External Device 


External Device or 
Line Frequency Clock 


The interrupt levels, numbered 0 hrough 15, determine the interrupt 
priority. Level 0 has the highest priority and level 15 the lowest. 
The contents of the interrupt mask, bits 12 through 15 of the ST re- 
gister, determine the enabled interrupt levels. Table 3-5 shows the 
interrupt levels enabled by the contents of the interrupt mask. Note 
that level O cannot be disabled since the level contained in the mask 


is always enabled. 


Table 3-5. Interrupt Mask 


Status Register 
Bits 12-15 zntecsups Levels Enabled 
1 0,1 
2 0;:152 
3 6;1,2,3 
4 0,1,2,3,4 
5 0,.1,253,: 455 
6 OA1,273,4;.5,6 
7 0, 1,2, 3,4, 5, 6,7 
8 0:1 ..2°3.4,5,6, 758 
9 0; 1,2,3:4,5;6,7,8,9 
A 0,1, 2,3, 4,5, 6,7, 8,9, 10 
B 0,1, 2,3, 4, 5, 6, 7, 8,9, 10, 11 
Cc 0,1,2,3.4.5; 6, 7,8,9, 10, 11, 12 
D 0,1, 2,.3, 4,5; 6, 7,8,9, 10, 11, 125.13 
E 0, 1,2, 3, 4, 5, 6, 7,8, 9, 10, 11, 12, 13,14 
F 0,1,2,3,4, 5, 6, 7, 8,9, 10, 11, 12, 13, 14, 15 


Mask Set 
By Interrupt 
Level 

0,1 


omen nun & WN 


—_ 
“~~ oO 
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3.89.5.2 Interrupt Sequence 
The level of the highest priority pending interrupt request is continually 
compared with the interrupt mask contents. When the level of the pending 
request is equal to or less than the mask contents (equal or higher 
priority) the interrupt is taken after the currently executing instruc- 
tion has completed. 


The workspace defined for the interrupt subroutine becomes active and 
the entry point is placed in the program counter. The CPU also stores 
the previous contents of the WP register in the new workspace register 
13, the previous contents of the program counter in the new workspace 
register 14, and the contents of the ST register in the new workspace 
register 15. This preserves the program environment existing when the 
interrupt is taken. No additional interrupt is taken until the first 
instruction of the interrupt subroutine is completed. Thereafter, in- 
terrupts of higher priority can interrupt processing of the current 
interrupt. 


After storing the ST register contents, the CPU subtracts one from 
the level of the interrupt taken and places the result in the inter- 
rupt mask, disabling the current interrupt level, and leaving only 
higher priority levels enabled. Should a higher priority level inter- 
rupt be taken, and the original interrupt request remain active when 
the return from the higher priority level interrupt subroutine occurs, 
the original interrupt remains disabled and is not taken again. Con- 
trol returns to the interrupt subroutine at the point at which the 
higher priority interrupt occurred. 


3.89.5.3 Pre-Defined Interrupts 


Level 0 is pre-defined as the power on interrupt in the TA 1630 Computer. 
Refer to the TA 1630 Operator's Manual TA 1630 for the levels that are — 
pre-defined. The total number of levels is 16 in the TA 1630 Computer. 
The available interrupt levels that are not pre-defined are available 

for assignment to devices on the CRU, or on the CRU and the TILINE. 
Several interrupt lines may be combined at one level. Any interrupt 
request must remain active until the interrupt is taken, and must be 
reset before the interrupt subroutine is completed. 


3.89.5.4 CPU Error Interrupt 


A CPU error interrupt is defined as an interrupt level two. 


On the TA 1630 Computer, any one of five conditions can cause a CPU 
error interrupt. Table 3-6 contains a list of these conditions. To 
isolate the cause of the error, read the CRU Error Register. The CRU 
register is addressed by placing a 1FCO,, in register 12, An individual 
error is cleared by addressing the appropriate CRU bits as listed in 
table 3-6, The memory mapping error is cleared by addressing bit 4 at 
the CRU base address 1FAO,,, the CRU base address used to control the 
mapping hardware. Either the SBZ or SBO instruction is used to clear 
the interrupts. 
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3.89.5.5 Interrupt Processing Example 
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Refer to figure 3-6 for the following discussion. Prior to the example 
interrupt (eight for this example), the PC contains 1022 for the exe- 
cuting program, the WP contains 780 for the executing program work- 
space, and the ST register contains the executing program status. At 
this point, the example external interrupt, number eight, occurs and 
there is a context switch from the executing program to the interrupt 
subroutine. The two words of memory required for external interrupt 
eight are found in memory locations 0020 and 0022. Figure 3-6 shows 
that these two words of memory contain 0270 and 0290, respectively, 
for the WP and PC that are to be used by the interrupt subroutine. 


At the point of interrupt, the CPU transfers the present WP, PC, and 
ST register contents to the interrupt routine workspace in workspace 
register 13, 14, and 15, respectively. Once these are stored, the CPU 
transfers the interrupt subroutine WP and PC into the WP and PC re- 
gisters. 


When these actions are completed, the contents of memory and the re- 
gisters are as shown in figure 3-7. 


After the completion of the interrupt subroutine, the CPU restores 
the executing program WP, PC, and ST registers. Completion of the in- 
terrupt subroutine occurs when the RTWP instruction in the interrupt 
subroutine is executed. 


3.89.6 Extended Operations 


Extended operation instructions permit the extension of the existing 
instruction set to include additional instructions. In the TA 1630 
Computer, the instructions may be implemented by user-supplied hard- 
ware or software routines. Interface between a user program and the 
standard TA executive is implemented as XOP 15. 


Memory locations 0040;¢ through 007E;¢ are used for XOP vectors for 
software implemented XOPs. Vector contents are user supplied WP and 
PC addresses for the XOP routine workspace and starting address. 
Table 3-7 contains the addresses and contents of the 16 XOP vectors. 
Note that these vectors must be supplied and loaded prior to the XOP 
instruction execution. 


Table 3-6, Error Interrupt Logic CRU Bit Assignments 


Input Bit Output Bit Error Condition 

11 Memory Mapping Error 

12 12 Error from TILINE memory (parity/ 
error correcting) 

13 13 Illegal Operation 

14 14 Privileged instruction fetch with 
privileged mode off 

15 15 TILINE timeout 
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When the program module contains an XOP instruction that is software im- 
plemented, the AU locates the XOP WP and PC words in the XOP reserved 
memory locations and loads the WP and PC. When the WP and PC are loaded, 
the AU transfers control to the XOP instruction set through a context 
switch. When the context switch is complete, the XOP workspace contains 
the calling routine return data in WRs 13, 14, and 15. 


The XOP instruction passes one operand to the XOP (input to the XOP 
routine in workspace register 11 of the XOP workspace). At the comple- 
tion of the software XOP, the XOP routine should return to the calling 
routine with an RTWP instruction that will restore the execution envi- 
ronment of the calling routine to that in existence at the call to the 
XOP. 


An example of a software implemented XOP, shown in figure 3-8, causes 
XOP number two to be executed on the data stored at the address con- 
tained in workspace register 1 of the calling program module. Prior 

to the execution of the XOP, the PC contains the address of the XOP *1, 
2 instruction and the WP contains the address of the calling program 
workspace. At this point, the PC increments by two, to 922, and the XOP 
is executed. This execution is a context switch in which the XOP 
routine gains control of the execution sequence. Note that workspace 
register 1 of the calling program module contains the data address for 
the operand that is passed to the XOP routine. 


After the context switch is complete and the XOP subroutine is in con- 
trol (figure 3-9), the PC contains the starting address of the XOP 
subroutine and the WP contains the address of the XOP subroutine work- 
space. Workspace register 11 of the XOP subroutine contains the effec- 
tive address of the data to be used as an operand. Workspace registers 
13, 14, and 15 contain the return control information, which is used 
to return control to the main program module when the XOP subroutine 
completes execution, 
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Figure 3-6. Interrupt Processing Example 
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Figure 3-7. Memory Contents After Interrupt 
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Table 3-7. XOP Vectors 
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Vector Contents 


WP address for XOP workspace 


. PC address for XOP routine 


WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
WP address for XOP workspace 
PC address for XOP routine 
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Figure 3-8, Extended Operation Example 
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3.89.7 Special Control Instructions 


There are five special control instructions that permit the programmer 
to control the state of the execution process of the TA 1630 Computer. 
These instructions are: 


Instruction Mnemonic 
Load or Restart Execution LREX 
Clock On and Clock Off CKON/CKOF 
Reset RSET 
Execute X 

Idle IDLE 
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CAUTION 

In the TA 1630 computer, executing any of these instructions ex- 
cept Execute in a program executing under an executive may drasti- 
cally interfere with the executive's operation. The executive 
running in the TA 1630 Computer allow program execution only ina 
nonprivileged mode. Attempting to execute these instructions in a 
nonprivileged mode generates a error/interrupt. 
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Figure 3-9, Extended Operation Example after Context Switch 


LREX Applications 


The LREX instruction may be used to activate any desired function by 
placing a transfer vector for that function in addresses FFFC)¢ and 

FFFEy¢ and placing a subroutine and workspace to perform that function 

in the locations specified in the transfer vector. Typically, these loca- 
tions are ROM locations, and the LREX instruction activates a programmer's 
panel and loader function. Other functions could be performed either by 
using different ROM's in these locations, or by using RAM in these loca- 
tions and loading the desired data into the locations. 


The LREX instruction is a Privileged Mode instruction in the TA 1630 
Computer. 


3.89.72 


3.89.7.3 
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CKON/CKOF Applications 


These two instructions are used to turn on and turn off the clock, re- 
spectively. Through the use of these two instructions, the programmer 

may use the clock for timing operations, As an example, the clock may 

be used to time-out I/0 procedures by turning the clock on, counting the 
clock interrupts until the desired time is passed, and turning the clock 
off. This is possible only if the interrupt level for the real time clock 
has previously been enabled. 


The clock interrupt is normally attached to level 5, or optionally at 
level 15 on the TA 1630 Computer. The interrupt is normally cleared in 
the Clock Interrupt Service Routine with a CKOF /CKON instruction sequence. 


The RSET instruction also clears an interrupt. 


When a program executes under an executive, the executive uses the clock 
for timing various executive and user program functions. Executing either 
a CKON or a CKOF instruction interferes with normal operation of the 
executive. I/0 timeout is part of the support provided by the executive, 
and is not a user function. Refer to the user's guide for the appropriate 
executive for methods of timing user program functions supported by that 
executive. 


The CKON and CKOF instructions are Privileged Mode instructions in the 
Model TA 1630 Computer. 


RSET Applications 


RSET is primarily used to initialize the state of the computer and has 
the effect of clearing any pending interrupts. This instruction is use- 
ful at the start of a program to clear the state in existence so that 
the new application will not be adversely affected by the previous state 
of the computer. 


When a program executes under an executive, the executive processes in- 
ternal interrupts and external interrupts for supported devices. Execu- 
tion of an RSET instruction interferes with normal operation of the 
executive. Refer to the user's guide for the appropriate executive for 
permissable changes in the enabled interrupt level. 


The RSET instruction is a Privileged Mode instruction in the Model 
TA 1630. 


X_ Applications 


The execute instruction may be used to execute an instruction that is 
not in sequence without transferring control to the desired instruction. 
One useful application is to execute one of a table of instructions, se- 
lecting the desired instruction by using an index into the table of in- 
structions. The computed value of the index determines which instruction 
is executed. 


A table of shift instructions is an example of the use of the X instruc- 
tion. Place the following instructions at location TBLE: 


TBLE SLA R6,3 SHIFT WORKSPACE REGISTER 6 
SLA R7,3 SHIFT WORKSPACE REGISTER 7 
SLA R8,3 SHIFT WORKSPACE REGISTER 8 
TABEND EQU $-2 
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A character is placed in the most significant byte of workspace register 
5 to select the workspace register to be shifted to the left 3 bit po- 
sitions, ASCII characters A, B, and C specify shifting workspace regi- 
sters 6, 7, and 8, respectively. Other characters are ignored. The fol- 
lowing code performs the selection of the shift desired: 


SRL RS,8 MOVE TO LOWER BYTE 
Al RS,-'A’ SUBTRACT TABLE BIAS 
JLT NOSHFT ILLEGAL 

SLA RS,1 MAKE IT A WORD INDEX 
Cl RS, TABEND - TBLE 

JGT NOSHFT ILLEGAL 


x @TBLE(RS) 
NOSHFT EQU $ 


When using the X instruction, if the substituted instruction contains a 
Ts field or a Tg field that results in a two word instruction, the com- 
puter accesses the word following the X instruction as the second word, 
not the word following the substituted instruction. When the substituted 
instruction is a jump instruction with a displacement, the displacement 
must be computed from the X instruction, not from the substituted in- 
struction. 


CRU_INPUT/OUTPUT 


The communications register unit (CRU) performs single and multiple bit 
programmed input/output in the TA 1630 Computer. All input consists of 
reading CRU line logic levels into memory and output consists of setting 
CRU output lines to bit values from a word or byte of memory. The CRU 
provides a maximum of 4096 input and output lines that may be individually 
selected by a 12-bit address. The 12-bit address is located in bits 3 
through 14 of workspace register 12 and is the base address for all CRU 
communications, 


When a program executes under an executive, I/0 to supported devices is 
provided through the use of I/0 supervisor calls. For these CRU devices, 
it is not necessary to use the instructions described in the following 
paragraphs. Refer to the appropriate user's guide for information on the 
use of the I/0 supervisor call to the desired device under that executive. 


CRU I/0 Instructions 


There are five instructions for communications with CRU lines. They are: 


e SBO - Set CRU Bit To One. This instruction sets a CRU output line to 
a logic one. If the device on the CRU line is a data module, SBO re- 
sults in zero volts at the data module terminal corresponding to the 
addressed bit. 


e SBZ - Set CRU Bit To Zero. This instruction sets a CRU output line to 
a logic zero. If the device on the CRU line is a data module, SBZ re- 
sults in a float (no signal applied) at the data module terminal cor- 
responding to the addressed bit. 


e TB - Test CRU Bit. This instruction reads the digital input bit and 
sets the equal status bit (bit 2) to the value of the digital input bit. 


3.89.8.2 
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NOTE 
The CRU address of the SBO, SBZ, and TB instructions is determined 


as follows: 
Bits 3-14 of workspace register 12 equal the CRU base address 
+ 


The user supplied displacement in the instruction with sign 
bit extended 


Effective CRU address 


e LDCR - Load Communications Register. This instruction transfers the 
number of bits (1-16)specified by the C field of the instruction onto 
the CRU from the source operand. When less than nine bits are speci- 
fied, the source operand address is a byte address. When more than 
eight bits are specified, the source operand is a word address. The 
CRU address is the address of the first CRU digital output affected. 
The CRU address is determined by the contents of workspace register 
12, bits 3 through 14. 


e STCR - Store Communications Register. This instruction transfers the 
number of bits specified by the C field of the instruction from the 
CRU to the source operand. When less than nine bits are specified, 
the source operand address is a byte address. When there are nine or 
more bits specified, the source operand address is a word address, 

The CRU address is determined by workspace register 12, bits 3 through 
14, 


SBO Example 


Assume that a control device that turns on a motor when the computer sets 
a one on CRU line 10F;¢, and that workspace register 12 contains 02001 ¢, 
making the base address in bits 3 through 14 equal to 100;¢. The following 
instruction sets CRU line 10F]¢ to one: 


SBO 15 


If a data module were connected as the CRU device, the instruction would 
place zero volts on output line 15 of the module without affecting other 
lines. 


SBZ_ Example 

Assume that a control device that shuts off a valve when the computer sets 
a zero on a CRU line is connected to CRU line 2, and that workspace regi- 
ster 12 contains zero. The following instructions sets CRU line 2 to zero: 


SBZ Z 


If a data module were connected as the CRU device, output line 2 of that 
module would float at a voltage determined by the characteristics of the 
control device. No other CRU line would be affected by the instruction. 
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3.89.8.4 TB Example 


Assume that workspace register 12 contains 0140)¢, making the base address 
in bits 3 through 14 equal to AQ;¢. The following instructions would test 
the input on CRU line A416 and execute the instructions beginning at lo- 
cation RUN when the CRU line is set to one. When the CRU line is set to 
zero, execute the instructions beginning at location WAIT: 


TB ~ TEST CRU LINE 4 
JEQ RUN IF ON, GO TO RUN 


WAIT . IF OFF, CONTINUE 
RUN 


The TB instruction sets the logic level of the Equal bit of the ST regi- 
ster to the level on line 4 of the CRU device. 


3.89.9 TILINE Input/Output 


The set of machine instructions that communicate with the memory may be 
used to communicate with devices connected to the TILINE, as illustrated 
in Appendix I. To communicate with the TILINE device, these instructions 
must be coded with the TILINE addresses for the device. The hardware 
supplies the five most significant bits, each having the value of one, 
to convert the upper 1024 memory byte addresses to TILINE addresses. The 
actual TILINE address for a device and the significance of data trans- 
ferred to these addresses are device dependent. 


The Disk Executive TAXO supports I/0 to the available disc units. The 
user programs that execute under TAXO use the 1/0 supervisor call to per- 
form 1/0 to the disc. Refer to the user's guide for the appropriate exe- 
cutive for a description of the I/0 supervisor call and for a list of 
supported devices. 


3.89.10 Re-Entrant Programming 


Re-entrant programming is a technique that allows the same program code 
to be used for several different applications while maintaining the inte- 
grity of the data used with each application. The common program code and 
its associated constants are stored in one area in memory. Each function 
that uses that code is then assigned a unique workspace and data area 

so that as it executes the common code, its variable data is developed 
without affecting the variable data associated with any of the other 
functions that use the program. With this arrangement one function can 
execute the common code routine and be interrupted in the middle of the 
routine by another function that also uses the same routine. The second 
function then uses the routine for its purpose and returns control to the 
first function so that it can proceed from the point of interruption 
without returning to the start of the routine, Re-entrant programming of 
this type lends itself well to servicing similar peripheral devices that 
interface with the computer at different priority levels. The following 
characteristics apply to a re-entrant procedure: 
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e The procedure does not contain data except data common to all tasks. 


e The procedure does not alter the contents of any word in the procedure 
whether that word contains data or an instruction. 


Data that is unique to one or more tasks is in the data division for 
the task and is either in a workspace or is indirectly addressed, 


A very important application of a re-entrant procedure is one that con- 
trols a process using several sets of identical control devices through 
identical sets of CRU lines. Each task using the re-entrant procedure 
addresses a unique set of control devices that controls a set of equip- 
ment to perform the same process concurrently. The workspace for each 
task contains the CRU base address in workspace register 12 for the set 
of control devices for the task. The procedure addresses a control device 
by a displacement from the base address. For each task, the base address 
in workspace register 12 of its workspace controls the proper device. 
Figure 3-10 shows a procedure common to sixteen tasks, each of which uses 
an identical set of CRU lines at different CRU base addresses. 


MEMORY 


TASK A 


WR12 


EQUIPMENT 
FOR TASK A 


TASK B 


SHARED 
PROCEDURE EQUIPMENT 


ea he FOR TASK 8B 


EQUIPMENT 
FOR TASK F 
TASK F 


WR12 


(A)132213A 


Figure 3-10. Re-entrant Procedure for Process Control 
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The following is an example of re-entrant code. The following assumptions 
apply: 


e Workspace register 14 contains the address of a word that contains the 
size of a buffer, in bytes. 


e Workspace register 9 contains the start address of that buffer. 


e Label NOTFND is the location that contains the first instruction of a 
routine that is to be executed if the buffer does not contain a car- 
riage return character. 


e Label FOUND is the location of the first instruction of a routine 
that is to be executed when the buffer contains a carriage return. 


The re-entrant code is as follows: 


ENTER MOV *14,3 GET BUFFER SIZE 

MOV 9,8 GET START ADDRESS 

A 3,8 POINT TO END OF BUFFER 
LOOK C 9,8 CHECK FOR END 

JH NOTFND BRANCH AT END 

CB *9+, @CARRET CHECK CHARACTER 

JNE LOOK BRANCH WHEN NOT FOUND 
FOUND CHARACTER FOUND 
CARRET BYTE >D 


The code is re-entrant because it is not altered during execution of the 
code. Also, when execution resumes following an interruption, the work- 
space for the code again becomes active, and contains the correct values 
for resuming the execution as if execution had not be interrupted. 


Another possible version of the same code is as follows: 


ENTER MOV *14,@ADDLOC 
MOV 9,8 
Al 8,$-$ 

ADDLOC EQU $-2 

LOOK 1G 9,8 
JH NOTFND 
CB *9+,@CARRET 
JNE LOOK 

FOUND 

CARRET BYTE >D 


The code performs the same function by storing the buffer length in the 
word that contains the immediate operand of an AI instruction. As long as 
only one task using this code is active, there would be no problem. How- 
ever, if one task is interrupted after storing a value in ADDLOC and be- 
fore executing the AI instruction, and another task executes the code, the 
size of the buffer for the first task is lost. The code is not re-entrant 
because it alters data within itself. 
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SECTION 4 


ASSEMBLER DIRECTIVES 


4.1 Introduction 


Assembler directives and machine instructions in source programs supply 
data to be included in the program and control of the assembly process. 
The SDSMAC Assembler supports a number of directives in the following 


categories: 

e Directives that affect the Location Counter 

e Directives that affect the assembler output 

e Directives that initialize constants 

e Directives that provide linkage between programs 
e Miscellaneous directives. 


4.2 Directives That Affect the Location Counter 


As an assembler reads the source statements of a program, a component of 
the assembler called the location counter advances to correspond to the 
memory locations assigned to the resulting object code, The first nine 
of the assembler directives listed below initialize the location counter 
and define the value as relocatable, absolute, or dummy. The last three 
directives advance the location counter to provide a block or an area 

of memory for the object code to follow. The word boundary directive al- 
so ensures a word boundary (even address). The directives are: 
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Absolute Origin 
Relocatable Origin 
Dummy Origin 

Data Segment 

Data Segment End 

Common Segment 

Common Segment End 
Program Segment 

Program Segment End 
Block Starting With Symbol 
Block Ending With Symbol 
Word Boundary 
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Absolute Origin _AORG 


Syntax definition: 
[<label> b... AORGD... [<wd-exp>]6, .. Kcomment> ] 


AORG places a value in the location counter and defines the succeeding 
locations as absolute, Use of the label field is optional. When a label 
is used, it is assigned the value that the directive places in the loca- 
tion counter. The operation field contains AORG. The operand field is 
optional, but when used, contains a well-defined expression (wd-exp). 
The assembler places the value of the well-defined expression in the 
location counter. The comment field may be used only when the operand 
field is used, When no AORG directive is entered, no absolute addresses 
are included in the object program, When the operand field is not used, 
the length of all preceding absolute code replaces the value of the lo- 
cation counter, 


AORG >1000+X 


Symbol X must be absolute and must have been previously defined, If X 
has a value of 6, the location counter is set to 100616 by this direc- 
tive, Had a label been included, the label would have been assigned the 
value 1006 14. 


Relocatable Origin _RORG 
Syntax definition: 
[ <label>]b...RORGb... Kexp>]b... Kcomment> ] 


RORG places a value in the location counter; if encountered in absolute 
code, it also defines succeeding locations as program-relocatable, When 
a label is used, it is assigned the value that the directive places into 
the location counter. The operation field contains RORG, and the operand 
field is optional. The comment field may be used only when the operand 
field is used, 


When the operand field is not used, the length of the program segment, 
data segment, or specific common segment of a program replaces the value 
of the location counter. For a given relocation type X, the length of 
the X-relocatable segment at any time during an assembly is either of 
the following values: 


e@ The maximum value the location counter has ever attained as a result 
of the assembly of any preceding block of X-relocatable code. 


e Zero, if no X-relocatable code has been previously assembled, 


Clearly,since the location counter begins at zero, the length of a seg- 
ment and the "next available" address within that segment are identical. 
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If the RORG directive appears in absolute- or program-relocatable code 
and the operand field is not used, the location counter value is replaced 
by the current length of the program segment of that program, If the 
directive appears in data-relocatable code without an operand, the loca- 
tion counter value is replaced by the length of the data segment, Like- 
wise, in common-relocatable code, the RORG directive without an operand 
causes the length of the appropriate common segment to be loaded into 

the location counter. 


When the operand field is used, the operand must be an absolute or relo- 
catable expression (exp) that contains only previously defined symbols. 
If the directive is encountered in absolute code, a relocatable operand 
must be program-relocatable; in relocatable code, the relocation type 

of the operand must match that of the current location counter. When 

it appears in absolute code, the RORG directive changes the location 
counter to program-relocatable and replaces its value with the operand 
value. In relocatable code, the operand value replaces the current loca- 
tion counter value, and the relocation type of the location counter re- 
mains unchanged. 


The following example shows an RORG directive: 
RORG $-20 OVERLAY TEN WORDS 


The $ symbol refers to the location following the preceding relocatable 
location of the program. This has the effect of backing up the location 
counter ten words. The instructions and directives following the RORG 
directive replace the ten previously assembled words of relocatable code, 
permitting correcting of the program without removing source records, 

Had a label been included, the label would have been assigned the value 
placed in the location counter, 


An example of a RORG directive with no operand field is as follows: 
SEG2 RORG 


The location counter contents depend upon preceding source statements, 
Assume that after defining data for a program, which occupied 4416 bytes, 
an AORG directive initiated an absolute block of code. The absolute block 
is followed by the RORG directive in the above example. This places 

00441, in the location counter and defines the location counter as relo- 
catable, Symbol SEG2 is a relocatable value, 0044, « The RORG directive 
in the above example would have no effect except “ the end of an abso- 
lute block or a dummy block, described in the next paragraph. 


Dummy Origin _DORG 
Syntax definition: 


[ <label>]}b...DORGb...<exp>6... Kcomment> ] 
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DORG places a value in the location counter and defines the succeeding 
locations as a dummy block or section. When assembling a dummy section, 
the assembler does not generate object code, but operates normally in 
all other respects. The result is that the symbols that describe the 
layout of the dummy section are available to the assembler during as- 
sembly of the remainder of the program. The label is assigned the va- 
lue that the directive places in the location counter, The operation 
field contains DORG., The operand field contains an expression (exp), 
which may be either absolute or relocatable. Any symbol in the expres- 
sion must have been previously defined. When the operand is absolute, 
the location counter is assigned the absolute value. When the operand 
is relocatable, the location counter is assigned the relocatable value 
and the same relocation type as the operand, in which case space is re- 
served in the section which has that relocation type. 


The following example shows a DORG directive: 
DORG O 


The effect of this directive is to cause the assembler to assign values 
relative to the start of the dummy section to the labels within the dummy 
section, 


The example directive would be appropriate to define a data structure. 
The executable portion of the module (following a RORG directive) should 
use the labels of the dummy section as indexed addresses. In this manner, 
the data is available to the procedure regardless of the memory area 
into which the data is loaded. 


The following is another example of the DORG directive: 
RORG O 


: (code as desired) 
DORG $ 
(data segment) 
END 


The example usage of the DORG directive would be appropriate for the 
executable portion (procedure division) of a disk-resident procedure 
that is common to more than one task, and executes under the disk exe- 
cutive, It is assumed that the code corresponding to the dummy section 
is assembled in another program module. In this manner, the data in the 
task portion (dummy section) is available to the procedure portion. 


The DORG directive may also be used with data-relocatable or common-re- 
locatable operands to specify dummy data or common segments. The follow- 
ing example illustrates this usage: 


CSEG 'COM1' 

DORG $ "$" HAS A COMMON-RELOCATABLE VALUE 
LAB1 DATA $ 
MASK DATA >FOOO 


CEND 
SZC @MASK,@LAB1(R3) 
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In the example, no object code is generated to initialize the common 
segment, COMI, but all common-relocatable labels describing the struc- 
ture of the common block (including LAB] and MASK) are available for 
use throughout the program. 


Block Starting With Symbol BSS 
Syntax definition: 

[<label>]b...BSSb...<wd-exp>b... [<comment> ] 
BSS advances the location counter by the value of the well-defined ex- 
pression (wd-exp) in the operand field. Use of the label field is optio- 
nal, When a label is used, it is assigned the value of the location of 
the first byte in the block. The operation field contains BSS. The ope- 
rand field contains a well-defined expression that represents the num- 
ber of bytes to be added to the location counter, The comment field is 
optional. 


The following example shows a BSS directive: 
BUFF1 BSS 80 CARD INPUT BUFFER 


This directive reserves an 80-byte buffer at location BUFF]. 


Block Ending With Symbol BES 


Syntax definition: 
[<label> ]b...BESb...<wd-exp>b... [<comment> ] 


BES advances the location counter according to the value in the operand 
field, Use of the label field is optional, The label is assigned the va- 
lue of the location following the block when the label is entered, The 
operation field contains BES, The operand field contains a well-defined 
expression that represents the number of bytes to be added to the loca- 
tion counter, The comment field is optional, 


The following example shows a BES directive: 


BUFF2 BES >10 


The directive reserves a 16-byte buffer, Had the location counter con- 
tained 10014 when the assembler processed this directive, BUFF2 would 
have been assigned the value 110)¢. 


Word Boundary EVEN 


Syntax definition: 
[<label> . ee EVENS. ee [<comment> ] 


EVEN places the location counter on the next word boundary (even) byte 
address. When the location counter is already on a word boundary, the 
location counter is not altered. Use of the label field is optional. 
When a label is used, the value in the location counter after processing 
the directive is assigned to the label, The operation field contains 
EVEN. The operand field is not used, and the comment field is optional. 
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The following example shows an EVEN directive: 
WRF1 EVEN WORKSPACE REGISTER FILE ONE 


The directive assures that the location counter contains a word boundary 
address, and assigns the location counter address to label WRF1. Use of 
an EVEN directive preceding or following a machine instruction or a DATA 
directive is redundant. The assembler advances the location counter to 
an even address when it processes a machine instruction or a DATA di- 
rective, 


4.2.7 Data Segment DSEG 
Syntax definition: 


[<label> ...DSEGb... [<comment> ] 


DSEG places a value in the location counter and defines succeeding loca- 
tions as data-relocatable. Use of the label field is optional. When a 
label is used, it is assigned the data-relocatable value that the direc- 
tive places in the location counter. The operation field contains DSEG, 
The operand field is not used, and the comment field is optional. Either 
of the following values is placed in the location counter: 


e The maximum value the location counter has ever attained as a result 
of the assembly of any preceding block of data-relocatable code 


e Zero, if no data-relocatable code has been previously assembled. 


The DSEG directive defines the beginning of a block of data-relocatable 
code, The block is normally terminated with a DEND directive (see para- 
graph 4.2.8). If several such blocks appear throughout the program, they 
together comprise the data segment of the program, The entire data seg- 
ment may be relocated independently of the program segment at link edit 
time and therefore provides a convenient means of separating modifiable 
data from executable code, 


In addition to the DEND directive, the following directives will properly 
terminate the definition of a block of data-relocatable code: PSEG, CSEG, 
AORG, and END, The PSEG directive, like DEND, indicates that succeeding 
locations are program-relocatable. The CSEG and AORG directives effec- 
tively terminate the data segment by beginning a common segment or ab- 
solute segment, respectively, The END directive terminates the data seg- 
ment as well as the program. 


The following example illustrates the use of both the DSEG and the DEND 
directives. 


RAM DSEG = START OF DATA AREA 


<Data-relocatable code> 


ERAM DEND 
LRAM EQU ERAM-RAM 
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The block of code between the DSEG and DEND directives is data-relocatable, 
RAM is the symbolic address of the first word of this block; ERAM is the 
data-relocatable byte address of the location following the code block. 

The value of the symbol LRAM is the length in bytes of the block. 


Data Segment End _DEND 
Syntax definition: 
[<label> }b...DENDb... [<comment>] 


DEND terminates the definition of a block of data-relocatable code by 
placing a value in the location counter and defining succeeding locations 
as program-relocatable, Use of the label field is optional. When a label 
is used, it is assigned the value of the location counter prior to modi- 
fication. The operation field contains DEND. The operand field is not 
used, and the comment field is optional. Either of the following values 
is placed in the location counter as a result of this directive: 


e The maximum value the location counter has ever attained as a result 
of the assembly of any preceding block of program-relocatable code, 


e Zero, if no program-relocatable code has been previously assembled, 


If encountered in common-relocatable or program-relocatable code, this 
directive functions as a CEND or PEND (and a warning message is issued); 
like CEND and PEND, it is invalid when used in absolute code. Refer to 
paragraph 4,2.7 for an example of the DEND directive. 


Common Segment CSEG 


Syntax definition: 
[<label> ...CSEGb... ['<string>']6... [<comment> ] 


CSEG places a value in the location counter and defines succeeding loca- 
tions as common-relocatable (i.e., relocatable with respect to a common 
segment), Use of the label field is optional. When a label is used, it 
is assigned the value that the directive places in the location counter. 
The operation field contains CSEG, and the operand field is optional. 
The comment field may be used only when the operand field is used, 


If the operand field is not used, the CSEG directive defines the begin- 
ning of (or continuation of) the "blank common" segment of the program, 
When the operand field is used, it must contain a character string of up 
to six characters, enclosed in quotes, (If the string is longer than 

six characters, the assembler prints a truncation error message and re- 
tains the first six characters of the string.) If this string has not 
previously appeared as the operand of a CSEG directive, the assembler 
associates a new relocation type with the operand, sets the location 
counter to zero, and defines succeeding locations as relocatable with 
respect to the new relocatable type. When the operand string has been 
previously used in a CSEG, the succeeding code represents a continuation 
of that particular common segment associated with the operand, The loca- 
tion counter is restored to the maximum value it previously attained 
during the assembly of any portion of the particular common segment. 


4/8 


The following directives will properly terminate the definition of a 
block of common-relocatable code: CEND, PSEG, DSEG, AORG, and END, The 
block is normally terminated with a CEND directive (see paragraph 4.2.10). 
The PSEG directive, like CEND, indicates that succeeding locations are 
program-relocatable, The DSEG and AORG directives effectively terminate 
the common segment by beginning a data segment or absolute segment. The 
END directive terminates the common segment as well as the program. 


The CSEG directive permits the construction and definition of indepen- 
dently relocatable segments of data which several programs may access 

or reference at execution time. The segments are the assembly language 
counterparts of FORTRAN blank COMMON and labeled COMMON, Information 
placed in the object code by the assembler permits the linkage editor 

to relocate all common segments independently and to make appropriate 
adjustments to all addresses which reference locations within common 
segments, Locations within a particular common segment may be referenced 
by several different programs if each contains a CSEG directive with 

the same operand or no operand. 


The following example illustrates the use of both the CSEG and the CEND 
directives: 


COM1A CSEG 'ONE' 
<Common-relocatable code, type 'ONE'> 


. 
. 


CEND 
COM2A CSEG 'TWO' 


<Common-relocatable code, type 'TWO'> 


COM2B CEND 
COMIC CSEG ‘ONE’ 


<Common-relocatable code, type ‘ONE'> 


COM1B CEND 
COMIL DATA COMIB - COM1IA LENGTH OF SEGMENT ‘ONE’ 
COM2L DATA COM2B - COM2A LENGTH OF SEGMENT 'TWO' 


The three blocks of code between the CSEG and CEND directives are common- 
relocatable, The first and third blocks are relocatable with respect to 
one common relocation type; the second is relocatable with respect to 
another. The first and third blocks comprise the common segment 'ONE', 
and the value of the symbol COMIL is the length in bytes of this seg- 
ment. The symbol COM2A is the symbolic address of the first word of com- 
mon segment 'TWO'; COM2B is the common-relocatable (type 'TWO') byte ad- 
dress of the location following segment. (Note that the symbols COM2B 

and COMIC are of different relocation types and possibly different valves, ) 
The value of the symbol COM2L is the length in bytes of common segment 
"TWO'” 
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4.2.10 Common Segment End  CEND 


4.2.11 


Syntax definition: 
[<label> ...CENDb... [<comment> ] 


CEND terminates the definition of a block of common-relocatable code by 
placing a value in the location counter and defining succeeding loca- 
tions as program-relocatable., Use of the label field is optional. When 
a label is used, it is assigned the value of the location counter prior 
to modification, The operation field contains CEND. The operand field 
is not used, and the comment field is optional, Either of the following 
values is placed in the location counter as a result of this directive: 


e@ The maximum value the location counter has ever attained as a result 
of the assembly of any preceding block of program-relocatable code. 


e Zero, if no program-relocatable code has been previously assembled, 


If encountered in common- or program-relocatable code, this directive 
functions as a DEND or PEND (and a warning message is issued); like 
DEND and PEND, it is invalid when used in absolute code, See paragraph 
4.2.9 for an example of the use of the CEND directive. 


Program Segment PSEG 
Syntax definition: 


[<label>]}b...PSEGb... Kcomment> ] 


PSEG places a value in the location counter and defines succeeding loca- 
tions as program-relocatable., When a label is used, it is assigned the 
value that the directive places in the location counter. The operation 
field contains PSEG, The operand field is not used and the comment field 
is optional, Either of the following values is placed in the location 
counter: 


e The maximum value the location counter has ever attained as a result 
of the assembly of any preceding block of program-relocatable code. 


e Zero, if no program-relocatable code has been previously assembled, 


The PSEG directive is provided as the program-segment counterpart to the 
DSEG and CSEG directives. Together, the three directives provide a con- 
sistent method of defining the various types of relocatable segments. 
The following sequences of directives are functionally identical: 


DSEG DSEG 

Data-relocatable code> Data-relocatable code> 
DEND 

CSEG CSEG 
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<Common-relocatable code> <Common-relocatable code> 
CEND : 
PSEG PSEG 
<Program-relocatable code> <Program-relocatable code> 
PEND 

. END 
END 


4.2.12 Program Segment End PEND 


Syntax definition: 
[<label>]b...PENDb...[<comment> ] 


The PEND directive is provided as the program-segment counterpart to the 
DEND and CEND directives. Like those directives, it places a value in 

the location counter and defines succeeding locations as program-relo- 
catable (however, since PEND properly appears only in program-reloca- 
table code, the relocation type of succeeding locations remains unchanged, ) 
Use of the label field is optional. When a label is used, it is assigned 
the value of the location counter prior to modification, The operation 
field contains PEND, The operand field is not used, and the comment field 
is optional. The value placed in the location counter by this directive 
is simply the maximum value ever attained by the location counter as a 
result of the assembly of all preceding program-relocatable code. If en- 
countered in data- or common relocatable code, this directive functions 
as a DEND or CEND (and a warning message is issued), like DEND and CEND, 
it is invalid when used in absolute code. See paragraph 4.2.11 for an 
example of the use of the PEND directive. 


4.3 Directives That Affect The Assembler Output 


This category includes the directive that supplies a program identifier 
in the object code, and four directives that affect the source listing. 
The directives in this category are: 


e Program Identifier 
e Page Title 

e List Source 

e No Source List 


e Page Eject 


4.3.1 Program Identifier IDT 
Syntax definition: 


[ <label>]b...IDTb...'<string>'b... Kcomment> ] 
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IDT assigns a name to the program, An IDT directive must precede any 
machine instruction or assembler directive that results in object code. 
Use of the label field is optional, When a label is used, the current 
value of the location counter is assigned to the label. The operation 
field contains IDT, The operand field contains the program name (string), 
a character string of up to eight characters. When a character string 

of more than eight characters is entered, the assembler prints a trun- 
cation error message, and retains the first eight characters as the 
program name. The comment field is optional. 


The following example shows an IDT directive: 
IDT = "CONVERT' 


The directive assigns the name CONVERT to the program to be assembled, 
The program name is printed in the source listing as the operand of the 
IDT directive and appears in the page heading of the source listing. 
The program name is placed in the object code, but serves no purpose 
during the assembly. 


NOTE 

Although SDSMAC will accept lower case letters and special charac- 
ters within the quotes, ROM loaders, etc., will not. Therefore 
only upper case letters and numerals are recommended, 


Page Title  TITL 
Syntax definition: 


[<label> b...TITLb... '<string>'b [<comment> ] 


TITL supplies a title to be printed in the heading of each page of the 
source listing. When a title is desired in the heading of the first page 
of the source listing, a TITL directive must be the first source state- 
ment submitted to the assembler, This directive is not printed in the 
source listing. Use of the label field is optional. When a label is used, 
the current value of the location counter is assigned to the label. The 
operation field contains TITL. The operand field contains the title 
(string), a character string of up to 50 characters, When more than 50 
characters are entered, the assembler retains the first 50 characters 

as the title, and prints a truncation error message. The comment field 
is optional; the assembler does not print the comment, but does incre- 
ment the line counter, 


The following example shows a TITL directive: 
TITL '**REPORT GENERATOR**' 


This directive causes the title **REPORT GENERATOR** to be printed in 

the page headings of the source listing. When a TITL directive is the 
first source statement in a program, the title is printed on all pages 
until another TITL directive is processed. Otherwise, the title is printed 
on the next page after the directive is processed, and on subsequent 

pages until another TITL directive is processed, 


NOTE 

The maximum source record length is 60 characters. If a full 50- 
character title is desired, the operand field must be started at 
or before column 11 of the source record. 
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4.3.3 List Source LIST 
Syntax definition: 
[<label> b...LISTb... [comment> ] 


LIST restores printing of the source listing. This directive is required 
only when a No Source List directive is in effect, to cause the assembler 
to resume listing. This directive is not printed in the source listing, 
but the line counter increments, Use of the label field is optional. 

When a label is used, the current value of the location counter is as- 
signed to the label. The operation field contains LIST, The operand 

field is not used. Use of the comment field is optional, but the as- 
sembler does not print the comment. 


The following example shows a LIST directive: 
LIST 


The directive causes the source listing to be resumed with the next 
source statement, 


4.3.4 Source List UNL 
Syntax definition: 
[Klabel> }b...UNLb... [<comment> ] 


UNL inhibits printing of the source listing. The UNL directive is not 
printed in the source listing, but the line counter increments. Use of 
the label field is optional. When a label is used, the current value of 
the location counter is assigned to the label. The operation field con- 
tains UNL. The operand field is not used. Use of the comment field is 
optional, but the assembler does not print the comment. 


The following example shows a UNL directive: 
UNL 


The directive inhibits printing of the source listing. Use of the UNL 
directive to inhibit printing reduces assembly time and the size of the 
source listing. 


4.3.5 Page Eject PAGE 
Syntax definition: 


[<label> }...PAGEb... [<comment> ] 


PAGE causes the assembler to continue the source program listing on a 

new page. The PAGE directive is not printed in the source listing, but 
the line counter increments. Use of the label field is optional. When 

a label is used, the current value of the location counter is assigned 
to the label, The operation field contains PAGE. The operand field is 

not used, Use of the comment field is optional, but the assembler does 
not print the comment. 


The following example shows a PAGE directive: 
PAGE 
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The directive causes the assembler to begin a new page of the source 
listing. The next source statement is the first statement listed on 
the new page. Use of the page directive to begin new pages of the 
source listing at the logical divisions of the program improves docu- 
mentation of the program. 


Directives That Initialize Constants 


This category includes directives that place values in successive bytes 
or words of the object code, and a directive that places characters of 
text in the object code to be displayed or printed. It also includes 

a directive that initializes a constant for use during the assembly 
process, The directives are: 


e Initialize Byte 
e Initialize Word 
e Initialize Text 


e Define Assembly-Time Constant 


Initialize Byte BYTE 


Syntax definition: 
[<label>]b...BYTEb...<exp>[,<exp>]...6...[<comment>] 


BYTE places one or more values in one or more successive bytes of memory. 
Use of the label field is optional. When a label is used, the location 

at which the assembler places the first byte is assigned to the label. 
The operation field contains BYTE, The operand field contains one or 
more expression separated by commas, The expressions must contain no 
external references. The assembler evaluates each expression and places 
the value in a byte as an eight-bit two's complement number. When trun- 
cation is required, the assembler prints a truncation error message and 
places the rightmost portion of the value in the byte. The comment field 
is optional. 


The following example shows a BYTE directive: 
KONS BYTE >F+1,-1,'D'-'"=',0,'AB'-'AA' 


The directive initializes five bytes, starting with a byte at location 
KONS. The contents of the resulting bytes is 00010000, 11111111, 
00000111, 00000000, and 00000001, 


Initialize Word DATA 


Syntax definition: 


[<label> ]}b...DATAb.. .<exp>[,<exp>]...6... [<comment>] 


4.4.3 
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DATA places one or more values in one or more successive words of me- 
mory. The assembler advances the location counter to a word boundary 
(even) address. Use of the label field is optional, When a label is 
used, the location at which the assembler places the first word is as- 
signed to the label, The operation field contains DATA. The operand 
field contains one or more expressions separated by commas. The assem- 
bler evaluates each expression and places the value in a word as a 
sixteen-bit two's complement number. The comment field is optional. 


The following example shows a DATA directive: 
KONST DATA 3200, 1+'AB',-'AF',>F4A0, 'A' 


The directive initializes five words starting with a word at location 
KONS1, The contents of the resulting words are 0C801¢, 414316, BEBA)¢, 
F4A016, and 004114. Had the location counter contents been O10F 1, prior 
to processing this directive, the value assigned to KONS1 would be 0110)¢. 


Initialize Text TEXT 


Syntax definition: 
[<label> }. 3) oe ]'<string>'b. .» [<comment> ] 


TEXT places one or more characters in successive bytes of memory. The 
assembler negates the last character of the string when the string is 
preceded by a minus (-) sign (unary minus). Use of the label field is 
optional. When a label is used, the location at which the assembler 
places the first character is assigned to the label, The operation field 
contains TEXT, The operand field contains a character string of up to 

52 characters, which may be preceded by a unary minus sign. The comment 
field is optional. 


The following example shows a TEXT directive: 
MSG1 TEXT ‘EXAMPLE' MESSAGE HEADING 


The directive places the eight bit ASCII representations of the charac- 
ters in successive bytes. When the location counter is on an even address, 
the result, in hexadecimal representation, is 4558, 414D, 504C, and 45XX, 
XX represents the contents of the rightmost byte of the fourth word, 

which are determined by the next source statement. The label MSG1 is as- 
signed the value of the first byte address in which 45 is placed, Another 
example, showing the use of a unary minus, is as follows: 


MSG2 TEXT -'NUMBER' 


When the location counter is on an even address, the result, in hexa- 
decimal representation,is 4655, 4D42, and 45AE, The label MSG2 is as- 
signed the value of the byte address in which 4E is placed, 


4.4.4 Define Assembly-Time Constant FQU 


Syntax definition: 


<label>b...EQUB...<exp>b... [<comment> ] 


NOTE 
<exp> may not be a REF'd symbol. 
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EQU assigns a value to a symbol. The label field contains the symbol. 
The operation field contains EQU, The operand field contains an expres- 
sion, Use of the comment field is optional. 


The following example shows an EQU directive: 
SUM EQU 5 _ WORKSPACE REGISTER 5 


The directive assigns an absolute value to the symbol SUM, making SUM 
available to use as a workspace register address. Another example of 
an EQU directive is: 


TIME EQU HOURS 


The directive assigns the value of previously defined symbol HOURS to 
symbol TIME, When HOURS appears in the label field of a machine instruc- 
tion in a relocatable block of the program, the value is a relocatable 
value. The two symbols may be used interchangeably. Symbols in the ope- 
rand field need not have been previously defined, 


Directives That Provide Linkage Between Programs 


This category consists of two directives that enable program modules to 
be assembled separately and integrated into an executable program, One 
directive places one or more symbols defined in the module into the ob- 
ject code, making them available for linking. The other directive places 
symbols used in the module but defined in another module into the object 
code, allowing them to be linked. The directives are: 


e External Definition 
e External Reference 
e Secondary Reference 


e Force Load 


External Definition _ DEF 
Syntax definition 
[<label> b...DEFb.. -<symbol> 3 <symbol> ]...... [comment> ] 


DEF makes one or more symbols available to other programs for reference, 
The use of the label field is optional. When a label is used, the current 
value of the location counter is assigned to the label, The operation 
field contains DEF, The operand field contains one or more symbols, se- 
parated by commas, to be defined in the program being assembled. The 
comment field is optional. 


The following example shows a DEF directive: 
DEF ENTER, ANS 


The directive causes the assembler to include symbols ENTER and ANS in 
the object code so that these symbols are available to other programs. 


External Reference REF 


Syntax definition: 


[<label>]6...REFb...<symbol>[,<symbol>]...6... [<comment ] 
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REF provides access to one or more symbols defined in other programs. 
The use of the label field is optional. When a label is used, the cur- 
rent value of the location counter is assigned to the label. The ope- 
ration field contains REF. The operand field contains one or more sym- 
bols, separated by commas, to be used in the operand field of a subse- 
quent source statement, The comment field is optional. 


The following example shows a REF directive: 
REF ARG1,ARG2 


The directive causes the assembler to include symbols ARG] and ARG2 in 
the object code so that the corresponding addresses may be obtained 
from other programs. 


If a symbol is listed in the REF statement then a corresponding symbol 
must also be present in a DEF statement in another source module, If a 
one-to-one matching of symbols does not occurs then an error occurs at 
Link Edit time. The system will generate a summary list of all "unre- 
solved references". 


NOTE 

If a symbol in the operand field of an REF directive is the first 
operand of a DATA directive which results in the assembler placing 
the symbol at absolute location 0, the symbol will not be linked 
correctly, Use of the symbol at other locations will be correctly 
linked. 


4.5.3 Secondary External Reference SREF 
Syntax definition: 


[<label> }b...SREF...<symbol>, [<symbol>]...6... [<comment> ] 


SREF provides access to one or more symbols defined in other programs. 
The use of the label field is optional. When a label is used, the cur- 
rent value of the location counter is assigned to the label. 


The operation field contains SREF, The operand field contains one or 
more symbols, separated by commas, to be used in the operand field of 
a subsequent source statement. The comment field is optional. 


The following example shows an SREF directive: 
SREF ARG1, ARG2 


The directive causes the Link Editor to include symbols ARG] and ARG2 
in the object code so that the corresponding addresses may be obtained 
from other programs. 


SREF unlike REF does not require a symbol to have a corresponding symbol 
listed in a DEF statement of another source module, But the symbol will 
be an unresolved reference. 


NOTE 

If a secondary referenced (SREFed) symbol is used as the operand 
of a DATA directive, and the value of the symbol is loaded at pro- 
gram-relocatable location zero, and only at location zero, the 
symbol will not be correctly linked. 


1630/Ass/0281/e 


4/17 
4.5.4 Force Load LOAD 


Syntax definition: 


[<label> b...LOAD. .<symbol>[,<symbol> ]. .b.. [kcomment>] 


The LOAD directive is like a REF, but the symbol does not need to be 
used in the module containing the LOAD, The symbol used in the LOAD 
must be DEFed in some other module, LOADs are used with SREFs. If a 
one-to-one matching of LOAD-SREF pairs and DEF symbols does not occur, 
then unresolved references will occur during link editing. 


Figure 4-1 shows an example of the use of the SREF and the LOAD direc- 
tives: 


Module Al uses a branch table in module B to get one of the modules 
C, D, E, or F. Module Al knows which of the modules C, D, E, and F 

it will need. Module B has SREF for C, D, E, and F, Module C has a 
DEF for C, Module D has a DEF for D. Module E has a DEF for E, Module 


F has a DEF for F, Module Al has a LOAD for one or more of modules C, 
D, E, and F as needed, 


Figure 4-1, | SREF and LOAD Directives 


The LOAD and SREF directives permit module B to be written to handle 
the most involved case and still be linked together without unneeded 
modules, since Al only has LOAD directives for the modules it needs. 


When a link edit is performed, automatic symbol resolution will pull in 
the modules appearing in a LOAD directive. (See the TA 1630 Link Editor 
Reference Manual for more details on automatic symbol resolution. ) 


4.6 
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If the link control file included Al and A2, modules C and D would be 
pulled in, while modules E and F would not be pulled in. If the link 
control file included A3, modules E and F would be pulled in, while 
modules C and D would not be pulled in. If the link control file in- 
cluded A2, module C would be pulled in, while modules D, E, and F would 
not be pulled in, 


Miscellaneous Directives 


This category includes a directive that defines a symbol for an extended 
operation, and a directive that terminates a source program. The direc- 
tives are: 


e Define Extended Operation 


e Program End 


Define Extended Operation _DXOP 


Syntax definition: 
[<label> }b...DXOPb...<symbol>,<term>... [<comment>] 


DXOP assigns a symbol to be used in the operation field in subsequent 
lines to specify an extended operation. The use of the label field is 
optional, When a label is used, the current value in the location 
counter is assigned to the label, The operation field contains DXOP. 
The operand field contains a symbol followed by a comma and a term, 
The symbol assigned to an extended operation must not be used in the 
label or operand field of any other statement. The assembler assigns 
the symbol to an extended operation specified by the term, which must 
have a value in the range of 0 to 15, The comment field is optional. 


The following example shows a DXOP directive: 
DXOP _DADD, 13 


The directive defines DADD as extended operation 13, When the assembler 
recognizes the symbol DADD in the operation field, it assembles an XOP 
instruction that specifies extended operation 13. The following example 
shows the use of the symbol DADD in a source statement: 


DADD @)LABEL1(4) 


The assembler places the operand field contents in the T, and S fields 
of an XOP instruction, and places 13 in the D field. 


Program End END 


Syntax definition: 
[<label>]b...ENDb... [<symbol> ]b... [<comment>] 
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END terminates the assembly, The last source statement of a program is 
the END directive. When any source statements follow the END directive, 
they are ignored. Use of the label field is optional. When a label is 
used, the current value in the location counter is assigned to the 
symbol, The operation field contains END, Use of the operand field is 
optional. When the operand field is used, it contains a program relo- 
catable or absolute symbol that specifies the entry point of the pro- 
gram. When the operand field is not used, no entry point is placed in 
the object code. The comment field may be used only when the operand 
field is used, 


The following example shows an END directive: 
END = START 


The directive causes the assembler to terminate the assembly of this 
program, The assembler also places the value of START in the object 
code as an entry point, 


When a program executes in a stand-alone mode, and is loaded by the 
ROM loader, it must supply an entry point to the loader. When no ope- 
rand is included in the END directive, and that program is loaded by 
the ROM loader, the loader transfers control to the entry point of the 
loader, and attempts to load another object program. 
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SECTION 5 
PSEUDO-INSTRUCTIONS 


General 


A pseudo-instruction is a convenient way to code an operation that is 
actually performed by a machine instruction with a specific operand. 

The TA 1630 Computer Assembly Language includes two pseudo-instructions,. 
The pseudo-instructions are: 


e No Operation 


e Return 


No Operation NOP 
Syntax definition: 


[<label>] 6...NOPb... [ecomment>] 


NOP places a machine instruction in the object code which has no effect 
on execution of the program other than execution time. Use of the label 
field is optional. When the label field is used, the label is assigned 
the location of the instruction. The operation field contains NOP. The 
operand field is not used. Use of the comment field is optional. 


Enter the NOP pseudo-instruction as shown in the following example: 

MOD NOP 
Location MOD contains a NOP pseudo-instruction when the program is loaded. 
Another instruction may be placed in location MOD during execution to 


implement a program option. The assembler supplies the same object code 
as if the source statement had contained the following: 


MOD JMP $+2 


Return RT 
Syntax definition: 
([<label>)6...RTb6... [<comment>] 


RT places a machine instruction in the object code to return control to 
a calling routine from a subroutine. Use of the label field is optional. 
When the label field is used, the label is assigned the location of the 
instruction, The operation field contains RT. The operand field is not 
used, Use of the comment field is optional. 


Enter the RT pseudo-instruction as shown in the following example: 
RT 


The assembler supplies the same object code as if the source statement 
had contained the following: 


B =) 


When control is transferred to a subroutine by execution of a BL instruc- 
tion, the link to the calling routine is stored in workspace register 11. 
An RT pseudo-instruction returns control to the instruction following the 
BL instruction in the calling routine. 
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SECTION 6 
ASSEMBLERS 


General 


In this section the assembler which process the Assembly Language for 
the TA 1630 Computer is described, The name of this assembler is SDSMAC 
and it can only be executed with the TAXO operating system, 


Program Development System Assembler SDSMAC 


The Program Development System Assembler SDSMAC is a two-pass assembler 
that assembles object code for the TA 1630 Computer. SDSMAC executes 

on a TA 1630 Computer under the TAXO Disc Executive and is a part of 
the Program Development System. 


The SDSMAC assembler reads the source statements of a program two times. 
The first time (first pass), the assembler maintains the location coun- 
ter and builds a symbol table similar to those in a one-pass assembler. 
SDSMAC also copies the source statements for reading during the second 
pass. During the second pass, SDSMAC reads the copy of the source state- 
ments, and assembles the object code using the operation codes and the 
symbol table completed during the first pass. 


The only restrictions on forward references! are instances in which the 
value of the symbol affects the location counter. 


SDSMAC supplies the additional capability of Macro-instructions or 
MACROs. A macro is a user-defined set of assembly language source state- 
ments. Macro definitions assign a name to the macro and define the 
source statements of the macro. The macro name may then be used in the 
operation field of a source statement of the program to cause the as- 
sembler to insert the pre-defined source statements and assemble them 
along with the other source statements of the program. The macro capa- 
bility of SDSMAC allows the user to: 


e Define macros to specify frequently used sequences of source code, 


e Define macros for problem-oriented sequences of instructions to pro- 
vide a means of programming that may be more meaningful to users who 
are not computer-oriented, 


Macros are defined in a macro language consisting of eleven verbs des- 
cribed in Section 7, In addition to the macro language SDSMAC supports 
a number of extended capabilities described in subsequent paragraphs 
of this section. 


SDSMAC supports the assembly language as described previously, and pro- 
duces a source and object code listing and machine language object code. 
The output options (cross reference listing and symbol table output) are 
available with SDSMAC, In addition, the user may suppress all printed 
output of SDSMAC or request SDSMAC to only produce a copy of the expan- 
ded source program, 


Owen! 
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In addition to the macro capability, SDSMAC supports the following 
capabilities: 
e Use of parentheses in expressions 
e An additional arithmetic operator ('//') to perform right shifts 
e Logical operators in expressions 
e Relational operators in expressions 
e Nine additional output options 
e Workspace pointer directive 
e Copy source file directive 
e Conditional Assembly Directives 
e Define operation directive 
e Transfer vector pseudo-instruction 
e Define maximum macro level 
e Define source line length 
e Use of external referenced symbols in expressions 


e Extra symbolic addressing techniques. 


Use Of Parentheses In Expressions 


SDSMAC supports the use of parentheses in expressions to alter the order 
of evaluation of the expression, Nesting of pairs of parentheses within 
expresSions is also supported. When parentheses are used, the portion 

of the expression within the innermost parentheses is evaluated first. 
Then the portion of the expression within the next-innermost pair is 
evaluated. When evaluation of the portions of the expression within all 
parentheses has been completed, the evaluation is completed from left 

to right. Evaluation of portions of an expression within parentheses at 
the same nesting level may be considered to be simultaneous, 


For example, the use of parentheses in the expression LAB] + ((4+3)*7) 
would result in the addition of 4 and 3, The result, 7, would be multi- 
plied by 7, giving 49. The complete evaluation would be the value of 
LAB] plus 49, Without parentheses, 4 would have been added to the value 
of LAB1, and 3 would have been added to the sum, The sum of the second 
addition would have been multiplied by 7 if LAB] had an absolute value, 
If LAB] had a relocatable value, the expression would have been illegal 
without the parentheses. 


o 
=> 
co 
S 
=~ 

) 
< 
oS 
oO 
Se) 


6.2.2 


6.2.3 


6/3 


Right Shift Operator 


In addition to the standard arithmetic operators used in expressions 
(add, subtract, multiply, divide), SDSMAC supports the operator // 
(double slash) to perform right shifts, The operator is used in the 
expression as follows: 


<operand> // <shift count> 


The operand may be an immediate value, a previously defined symbol, or 
a forward referenced symbol. The expression can not be relocatable. The 
precedence of this operator follows the normal left-to-right precedence 
unless the expression is modified by parentheses. 


Logical Operators In Expressions 


SDSMAC supports logical operations in expressions, which are the bit-by 
bit logical operations between the values of the symbols and/or con- 
stants. The logical operators are as follows: 


e & for AND 

e && for exclusive OR 

e ++ for OR 

e # for NOT (logical complement) 


The order of evaluation of expressions that contain logical operators 

is similar to that of expressions that contain only arithmetic operators. 
Like the unary minus, the logical complement takes precedence over other 
operations regardless of position, except as altered by parentheses. 


The following are examples of expressions that contain logical operators: 


BLUE&&255 Specifies the result of an exclusive OR 
operation between the bits of the value 
of symbol BLUE and the bits of constant 
value 255, 


GREEN++15 Specifies the result of an OR operation 
between the bits of the value of symbol 
GREEN and the bits of constant value 15, 


RED& #4255 Specifies the result of an AND opera- 
tion between the bits of the value of 
symbol RED and the inversion of the 
bits of constant value 255, 


RED8& 44255++( BLUE&255 ) AND the value of BLUE with the constant 
255, AND the value of RED with the 1's 
complement of 255. OR the two AND re- 
sults to get the value of the expres- 
sion, 
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6.2.4 Relational Operators In Expressions 


SDSMAC supports six relational operators that represent the relationship 
between the two constants and/or symbols, the result of comparing the 
constants and/or symbols, When the relationship corresponding to the 
operator exists (is true), the value of the combination is 1. When the 
relationship corresponding to the operator does not exist (is not true), 
the value of the combination is 0. The result may be used as an arith- 
metic value or as a logical value, The relational operators are as fol- 
lows: 


e = for equal 

e < for less than 

e > for greater than 

e <= for less than or equal 

e >= for greater than or equal 


# = for not equal. 


NOTE 

The greater than character (>) is also used to identify hexadeci- 
mal constants. The context determines the meaning of the greater 
than character in each statement. 


The following are examples of expressions that contain relational ope- 
rators: 


BLUE #=GREEN Compares the value of symbol BLUE to 
the value of symbol GREEN, When the 
values are not equal, the combination 
has a value of one. When the values 
are equal, the combination has a value 
of zero, 


WHITE<BLACK Compares the value of symbol WHITE to 
the value of symbol BLACK, When the 
value of WHITE is less than the value 
of BLACK, the combination has a value 
of one, Otherwise, the value of the 
combination is zero. 


RED* (GREEN=0) Compares the value of symbol GREEN to 
zero. When GREEN equals zero, the value 
of symbol RED is multiplied by 1, and 
the value of the expression is that of 
symbol RED, When GREEN is not equal to 
zero, the multiplier is zero, and the 
value of the expression is zero, 


BLUE>=RED Compares the value of symbol BLUE to 
the value of symbol RED. When BLUE is 
greater than or equal to RED, the combi- 
nation is equal to one. When BLUE is 
less than RED, the combination is equal 
to zero. 
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6.2.5 Output Options 
OPTION directive, 
Syntax definition: 
b...OPTIOND...<keyword> [,<keyword>] ...b... [<comment>] 


OPTION specifies output and list options to the assembler. No label is 
entered with the OPTION directive. The operation field contains OPTION, 
The operand field contains one or more of the keywords to specify the 
desired options. The comment field is optional. 


The keywords supported by SDSMAC, and their meanings, are as follows: 


e XREF - Print a cross reference listing at the end of the source and 
object listing. 


e RXREF - Print a reduced cross-reference listing at the end of the 
source listing. (The reduction deletes all symbols defined in state- 
ments COPY'd into the source that are not referenced in the original 
source, ) 


e SYMT - Output a symbol table in the object code that contains all 
symbols in the program, 


e NOLIST - Suppress printing of any listing. Overrides other direc- 
tives and keywords. 


e TUNLST - Limit the listing for text directives to a single line. 
e DUNLST - Limit the listing for data directives to a single line. 
e BUNLST - Limit the listing for byte directives to a single line. 
e MUNLST - Limit the listing for a macro expansion to a single line, 
e FUNL - Overrides unlist directives, 
The following example shows an OPTION directive: 
OPTION XREF,SYMT 


The directive in the example specifies the printing of a cross reference 
listing and the output of a symbol table with the object code. 


6.2.6 Workspace Pointer 
WPNT directive, 


Syntax definition: 
[<label>]...WPNTb...<label>b... Ecomment> ] 


WPNT defines the current workspace to the assembler. WPNT generates no 
object code, The user must provide a machine instruction to actually 
place the value in the workspace register, The symbol in the label field, 
when used, must represent a word (even) address and must have been pre- 
viously defined, The operation field contains WPNT. The operand field 
contains the label assigned to the workspace. The comment field is op- 
tional, 


6.2.7 
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The following example shows a WPNT directive: 
WPNT WORK 


The directive in the example is appropriate when the workspace at loca- 
tion WORK is the active workspace. The assembler stores the value of 
label WORK as the current workspace address, and from this information 
identifies symbolic addresses as workspace registers when the symbolic 
addresses have values greater than WORK by 15 or less. The assembler 
also recognizes WORK or a label equal to WORK as workspace register 0. 
Symbolic addresses having values outside this range are considered to 
be symbolic memory addresses, 


Copy Source File 
COPY directive, 


Syntax definition: 
[<label>]b...COPYb...<file name>b...[<comment>] 


COPY changes the source input for the assembler, Use of the label field 
is optional, The operation field contains COPY. The operand field con- 

tains a file name from which the source statements are to be read. The 

file name may be: 


e An access name recognized by TAXO operating system. 
e A synonym form of an access name, 
The comment field is optional. 
The following example shows a COPY directive: 
COPY «oF LLE 


The directive in the example causes the assembler to take its source 
statements from a file SFILE, At the end-of-file of SFILE, the assem- 
bler resumes taking source statements from the file or device from 
which it was taking source statements when the COPY directive was pro- 
cessed, A COPY directive may be placed in a file being copied, which 
results in nested copying of files. 


Conditional Assembly Directives 
Syntax definition: 


[<label> }b...ASMIFb.. .<wd-exp>b... [<comment>] 
Assembly language statements 
b... ASMELSb.. [<comment> ] 
Assembly language statements 


... ASMENDb.. [<comment> ] 
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Three directives, ASMIF, ASMELS and ASMEND, furnish conditional assembly 
capability in SDSMAC. The three function as IF-THEN-ELSE brackets for 
blocks of assembly language statements. When the expression in the ope- 
rand field of an ASMIF evaluates to a non-zero (or true) value, the 
block of statements enclosed by either ASMIF-ASMEND or ASMIF-ASMELS is 
assembled, If the block is terminated by ASMELS, the block enclosed 

by ASMELS-ASMEND is not assembled. When the expression on an ASMIF 
evaluates to zero (or false), the block of statements immediately fol- 
lowing ASMIF is not assembled, If an alternate ASMELS block occurs, 

it is assembled, Statements, including macro calls, which occur in 
portions not assembled are treated as comments, Note that macro calls 


treated as comments will not be expanded. The ASMIF expression must 
be well defined when it is encountered, 


WARNING 


ASMIF, ASMELS and ASMEND may not appear as macro model statements, 
ASMIF-ASMELS-ASMEND constructs may be nested, 


The following example shows the use of conditional assembly, 
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SDSMAC 947875 *E 88:44:26 
PAGE 8ao1 
aL * 
Bae * THIS IS AN EXAMPLE OF A USE OF CONDITIONAL ASSEMBLY 
Baas * TO INCLUDE VARIOUS LEVELS OF DEBUG INFORMATION. 
Bees * 
Poa] Sb * A SYMBOL IS DEFINED WHICH INDICATES THIS LEVEL 
Bans * 6 - NO DEBUG 
ao87 + 2 - ENTRY “EXIT SHORT DUMPS 
Baas * 16- THE ABOVE. OUTER LOOP SHORT DUMPS, ENTRY7EXIT 
anes * LONG DUMPS 
aoi18 * 45- ALL THE ABOVE #& INNER LOOP SHORT DUMPS 
Bait + 
BeL2 eaac DEBUG EQU 412 
Ae13 * A VALUE OF 12 FOR DEBUG WILL GIYE THE FIRST 2 LEVELS 
aei4 * OF DEBUG INFORMATION 
a615 * 
Ba16 REF SRTOMP. LNGDMP 
a1? * PROGRAM ENTRY POINT 
9613 DEF ENTRY 
8819 Baas ENTRY 
Bas ASMIF DEBUG IF DEBUG=@, SKIP THIS BLOCK* 
Bast ' ASMIF DEBLIG?S : * 
BB22 BeBe B6AG BL LNGDMP ENTRY POINT LONG DUMF = * 
Bee2 Baae . 
Ps Pe ASMELS * 
Aas BL SRTOMP ENTRY POINT SHORT DUMP * 
Bees ASMEND * 
Bess ASMERD AE AR A of OR oi 
@827 Baa4 C1SB MOY Rid. RS (SAVE RETURN ADDRESS> 
Bass * 
B823 * <CODE> 
Aaze * | 
GGS1 * OUTER LOOF 
BHS2 Baas LABELL 
BOZ2 BEES Beas ES | RS. >1ae 
Bees alae 
* INNER LOOP 
ABBA LABEL? 
BBeR Aze4 LI 4.6 
Baer eee 
AAS? * 
Base * <CODE> 
aoz9 + 
ao4a ASMIF DEBLIGD=15 
add BL SRTDMF INNER LOOP SHORT DUMP 
aa42 ASMENL: 
BA4S GORE B6ed DEC Fd 
Aa44 G18 15FC JGT —ABEL2 
ga45 4 
ist et + <IDODED 
Bed? 
PsTsre tg ASMIF CEBUG>=16 
BA43 BH12 B6Re BLO SRTOMP OUTER LOOF SHORT CLIMF 
Beds Bee 
aease ASMENL 
WAS. Ga16 B6as bec FS 
GA52 G15 15F6 IGT LABELA 
Hass + 
bas * <CODE> 
ae * 
aes * EXIT FOIN 
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easr 
6a53 
aass 


BG68 
S661 
Sa62 
6a5= 
So64 
BaES 


NO ERRORS 


661A B6Aa 
610 Bae2° 


ASMIF DEBUG 
ASMIF DEBUG>S 
BL LNGDMF 


ASMELS 
BL SRETDMP 
ASMEND 
ASMEND 


@61E 4456 B *RG 


END 


PAGE 8oa2 


IF DEBUG=6, SKIP THIS BLOCK* 
+ 


EXIT LONG DUMP * 
* 

EXIT SHORT DUMP * 
* 

aE oR a aK 


CRETURN THROUGH SAYED REGISTER 
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Define Operation 
DFOP directive, 


Syntax definition: 
[klabel> )...DFOPb...<symbol>,<operation>... [<comment> ] 


DFOP defines a synonym for an operation. Use of the label field is op- 
tional, The operation field contains DFOP, The operand field contains 

a symbol which is the synonym for an operation, and the operation, which 
may be the mnemonic operation code of a machine instruction, a macro 
name, or the symbol of a previous DFOP or DXOP directive. The comment 
field is optional. 


The following example shows a DFOP directive: 
DFOP LD, MOV 


The directive in the example defines LD for a synonym for the MOV machine 
instruction. The LD symbol might be more meaningful where the source is 

a symbolic memory location and the destination is a workspace register. 
The machine code for the MOV instruction is assembled whenever either 
symbol appears in the operation field of a source statement. A single 
symbol may appear in more than one DFOP directive in the same assembly, 
and an operation symbol may appears as the defined symbol of a DFOP 
directive, the corresponding operation is not available unless it had 
appeared in the operand field of a previous DFOP directive. The effect 

of a group of DFOP directives is shown in the following example: 


DFOP HOLD, LWPI HOLD DEFINED TO BE LWPI 
DFOP LWPI,SOMMAC LWPI REDEFINED AS MACRO SOMMAC 


DFOP SAVE,HOLD SAVE DEFINED AS HOLD (LWPI) 
DFOP HOLD,BLWP HOLD REDEFINED AS BLWP 
DFOP LWPI,SAVE LWPI RESTORED 


The first pair of DFOP directives substitutes macro SOMMAC for the LWPI 
machine instruction, which may be specified by the symbol HOLD. The se- 
cond pair of DFOP directives changes the symbol by which the LWPI ma- 
chine instruction is specified to SAVE, and the symbol by which the BLWP 
instruction is specified to HOLD, The last DFOP directive restores the 
symbol LWPI to the LWPI machine instruction, 


Transfer Vector 
XVEC directive, 


Syntax definition: 


<label>b...XVECb...<wp address>[,<subr address>]6... [<comment> ] 
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The XVEC pseudo-instruction is a means of coding the transfer vector 
for a subroutine. XVEC places a set of assembler directives in the 
source code to provide a transfer vector for a BLWP instruction. XVEC 
also provides a WPNT directive to define the newly active workspace 

to the assembler. The label field contains the label of the resulting 
transfer vector. The operation field contains XVEC. The operand field 
contains the label (wp address) of the workspace that becomes active 
when the BLWP instruction is executed, Optionally, the wp address may 
be followed by a comma and the label (subr address) of the first instruc- 
tion to be executed in the subroutine. When the second operand is omit- 
ted, the assembler assumes that the first instruction to be executed 
follows the transfer vector. The use of the comment field is optional. 


Enter the XVEC pseudo-instruction as shown in the following example: 
SUBRA XVEC WKSPA, ENTRYA 


Transfer of control to a subroutine at location ENTRYA with a workspace 
at location WKSPA becoming the active workspace is coded as follows: 


BLWP SUBRA 


The resulting object code and assembler processing is the same as would 
result from the following directives: 


SUBRA DATA WKSPA 
DATA ENTRYA 
WPNT WKSPA 


Alternatively, the XVEC pseudo-instruction may be entered as follows: 
SUBRA XVEC WKSPA 


In this case, the executable code of the subroutine must immediately 
follow the XVEC pseudo-instruction, The resulting object code and assem- 
bler processing is the same as would result from the following direc- 
tives: 


SUBRA DATA WKSPA 
DATA S+2 
WPNT WKSPA 


NOTE 

No executable code that requires a different active workspace than 
that of the subroutine may be entered between the XVEC pseudo-in- 
struction and the subroutine entry address. 


Set Maximum Macro Nesting Level 
SETMNL directive, 


Syntax definition: 
[ <label>}b...SETMNLb...<exp>... Kcomment> ] 
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The SETMNL directive allows the programmer to change the maximum macro 
nesting stack level as required, SDSMAC maintains a count of the num- 
ber of levels of macro nesting and declares an error if this count ex- 
ceeds the maximum number allowed, The default maximum is sixteen, The 
SETMNL directive may be used to set the allowed maximum to greater or 
less than sixteen. 


6.2.12 Set Right Margin 
SETRM directive. 


Syntax definition: 
[<label>]}b...SETRMb. .<wdexp>b... [<comment>] 


The SETRM directive allows the programmer to specify the number of cha- 
racters in the source line to be considered by the assembler. Use of 
the label field is optional. The operation field contains SETRM. The 
operand field is required, and contains a well-defined expression. Use 
of the comment field is optional. 


The assembler will use the value of the expression to determine which 
is the last character of the source line to be considered for the as- 
sembly, Initially, the assembler scans 60 characters. The new value may 
range from 10 to 80, The right margin value may be changed at any point 
in the assembly and any number of times. 


NOTE 

The assembler ordinarily prints only 60 characters. The print 
length can be modified with the Execute Macro Assembler (XMA) 
SCI command, PRINT WIDTH prompt. 


6.2.13 Use Of External Referenced Symbols In Expressions 


SDSMAC will allow external referenced symbols (defined in REF and SREF 
directives) in expressions under the following conditions: 


1. Only one externally referenced symbol may be used in an expression. 


2. The character preceeding the referenced symbol must be a plus sign, 
a blank, or a comma (at sign "@' is not considered), The portion of 
the expression preceeding the symbol, if any,must be added to the 
symbol, 


3, The portion of the expression following the referenced symbol must 
not include multiplication, division, or logical operations on the 
symbol (same as for a relocatable symbol, paragraph 2.8). 


4, The remainder of the expression except the referenced symbol must be 
absolute (relocatable symbols may be used - see paragraph 2.8). 


As a result of this feature, SDSMAC now limits the user to a total of 
255 external referenced symbols per module, Modules using more than 
255 external symbols must be broken into smaller modules for assembly 
and linked using the link editor. 
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6.2.14 Symbolic Addressing Techniques 


SDSMAC processes symbolic memory addresses in a way so that the user 
may : 


e Use the symbolic memory address of a workspace register to address 
the workspace register. 


e Omit the @character to identify a symbolic memory address. 


When the SDSMAC processes a symbol as an operand of a machine instruc- 
tion, it compares the value of the symbol to the address of the current 
workspace. When the value is equal to the workspace address, or is 
greater by 15 or less, the symbol represents a workspace and SDSMAC 
assembles a workspace register address, Otherwise SDSMAC assembles a 
symbolic memory address. A WPNT directive or an LWPI instruction sup- 
plies the address of the current workspace to the assembler. 


Without this capability, two symbols are frequently assigned to the same 
address. The following example illustrates this type of coding: 


SUM EQU 0 ASSIGN SUM FOR WORKSPACE REGISTER 0 
QUAN EQU ASSIGN QUAN FOR WORKSPACE REGISTER 1 
ws! DATA 0 WORKSPACE REGISTER 0 
QUANT DATA 0 WORKSPACE REGISTER 1 

5 WORKSPACE REGISTER 2 


FIVE DATA 


MOV GF IVE,@QUANT INITIALIZE QUANTITY 


BLWP @SUBI BRANCH TO SUBROUTINE 
SUB1 DATA WSI TRANSFER VECTOR 
DATA ENT! FOR SUBROUTINE 
ENTI A QUAN,SUM ADD QUAN TO SUM 


The two initial EQU directives assign meaningful labels to be used as 
workspace register addresses in the subroutine, The labels of the DATA 
statements are required to access the same memory locations in the main 
program, when another workspace is active. The following code would pro- 
duce the same object code when assembled on SDSMAC: 


SUM DATA 0 WORKSPACE REGISTER 0 
QUAN DATA 0 WORKSPACE REGISTER | 
FIVE DATA 5 WORKSPACE REGISTER 2 
MOV FIVE,QUAN INITIALIZE QUANTITY 
BLWP @SUB!1 BRANCH TO SUBROUTINE 
SUB1 XVEC SUM TRANSFER VECTOR FOR SUBROUTINE 
ENT! A QUAN,SUM ADD QUAN TO SUM 
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The MOV instruction in the main program results in symbolic memory ad- 
dresses for both operands. The BLWP instruction uses transfer vector 
SUB1, provided by the XVEC directive labelled SUB], The XVEC directive 
also provides a WPNT directive that identifies SUM as the address of 
the current workspace, The A instruction uses the symbol QUAN (as used 
in the MOV instruction) but results in a workspace register address, 
because QUAN is now workspace register 1. 


In the SDSMAC assembler, a @ character is not necessarily required, 
to denote the "indexed" mode of addressing where the instruction is de- 
fined as having a generalized address as an operand. SDSMAC considers 
the @ character as redundant if 


- all symbols in the expression have been previously defined and the 
resulting values of the expression is greater than 15, or 


- another @ character prefaces the expression. 


The following notations for the MOV instruction in the previous example 
would generate the same object and result in an error-free assembly: 


MOV @FIVE, @QUAN 
MOV FIVE, QUAN 


MOV @@FIVE, @@QUAN 


NOTE 

When the @ is omitted from a symbolic expression, the symbol 
must be defined before its use, If the symbol is not first de- 
fined, a register reference is assumed, If later the symbol is 
defined as a memory reference, an 'OPERAND CONFLICT PASS1/PASS2' 
error is generated, 
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SECTION 7 
MACRO_LANGUAGE 


General 


The SDSMAC assembler supports a macro defining language used in programs. 
A macro definition is a set of source statements (machine instructions 
and assembler directives) specified by a macro call in a source program. 
When the assembler processes a macro call it substitutes the predefined 
source statements of the macro definition for the macro call source 
statement, and assembles the substituted statements as if they had been 
included in the source program. MACRO definitions may be placed in a 
MACRO library for use in a subsequent assembly. This section describes 
the macro language, the verbs used to define macros, and the MACRO li- 
brary directives, 


Processing Of Macros 


Figure 7-1 illustrates the data paths between the basic assembler, the 
macro translator (consisting of the Statement Classify, Macro Define, 
and Macro Expander modules) and the Macro library. The Statement Classify 
module processes all source statements to detect macro language state- 
ments and macro calls, and ignoring non-macro language statements. A 
special macro language statement, $MACRO, identifies the beginning of 

a macro definition, and $END identifies the end of a macro definition. 
Statements that occur between these two statements constitute a macro 
definition, and are passed to the Macro Define module. The module writes 
them in the Macro library in an encoded form, The Macro Define module 
also supplies to the Statement Classify module the macro name. 


MACRO 


ENCODED 
EXPANDER MACRO 


STATEMENT 
CLASSIFY 


MACRO 
DEFINE 


PRIMARY 
INPUT 
(SOURCE 
PROGRAM ) 


ASSEMBLER 


Figure 7-1. Macro Assembler Block Diagram 
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The Statement Classify module recognizes a macro call by the macro name 
in the operation field, The Statement Classify module then passes the 
name to the Macro Expander module. The Macro Expander module accesses 
the desired macro definition, The macro call is expanded as specified 
in the macro definitions, The source statement that results from this 
expansion is used as input by the Statement Classify module, Macro 
calls will not be expanded if they occur in unassembled ASMIF or ASMELS 
code blocks, 


During the expansion of a macro call, a macro language statement may 
call another macro, or a resulting source statement may be a macro 
call, A nesting of Macro's calls can occur in the expansion of one 
Macro call, The macro processor suspends processing of the current 
macro, processes the new macro, then resumes processing the original 
macro at the point of interruption. The macro translator allows a macro 
to be a recursive, 


Macro Translator Interface With The Assembler 


Expansion of a macro call may be varied according to the contents of 
the assembler symbol table (AST) and may result in alteration of the 
contents of the AST, The AST contains an entry for each symbol identi- 
fied in the source program. The entry in the AST is divided into a num- 
ber of components. The value of the symbol is stored as the value com- 
ponent (is a binary value used in computations). The segment component 
contains the location counter segment number of the symbol, and the at- 
tributes of this symbol are stored in the attribute component as a group | 
of bits each of which represents an attribute of the symbol, The string 

component is null unless the macro translator places a string of cha- 

racters in it. The length component contains the number of characters 

in the string component. An eight-bit user attribute field allows spe- 

cial attributes to be defined for a symbol. In this section, the sym- 

bol table entry components are referred to as symbol components, | 


Using keywords, a macro definition may access any component of any sym- 
bol in the AST, Symbols that are operands of the macro call may be used 
in the definition without any further declarations, Other symbols used 

in the Macro definitions must be explicitly declared before use. 


A set of macro language statements beginning with a $MACRO statement 
and ending with a $END statement is a macro definition. The $MACRO 
statement includes a macro name that is used as the operation field. 
Macro definitions may appear anywhere in a program prior to macro calls 
that activate the definitions and may be unique to a program or shared 
by many programs, 


The LIBIN directive makes it easy to incorporate a library of previously 
encoded macro definitions in every program, These definitions become 

a part of the source program but they are used only when a macro is 
called in the source program. 
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A macro definition need only be as sophisticated as its application re- 
quires. The macro definition simply redefine an instruction, supply 

one or more fixed operands for commonly used instructions, contain one 
or more calls for other macros, or call itself recursively, The state- 
ments in a macro definition may access AST symbol components to specify 
processing of a macro or alter the contents of the AST. To prevent the 
assembler from getting into an infinite loop, the maximum nesting level 
for macros is sixteen, However, the SETMNL directive may be used to 
change the established maximum as required, 


MACRO Library 


A MACRO library is a TAXO directory and each member file of the direc- 
tory contains a MACRO definition. Two assembler directives, LIBIN and 
LIBOUT, identify MACRO libraries for input and output, respectively. In 
addition, a system MACRO library may be input via the assembler input 
parameters, 


The purpose of a MACRO library is to reduce execution time and memory 
overhead associated with using MACROs. Execution time is reduced by 
encoding the MACRO definitions only once and making them available for 
subsequent assembler runs. Memory requirements are reduced since MACRO 
definitions not under expansion reside only in the directory on disc. 


Macro Language Elements 


The elements of the macro language are labels, strings, constant opera- 
tors, variables, variable qualifiers, keywords, and verbs. A macro defi- 
nition consists of statements containing macro language verbs and model 
statements. A model statement can be constructed from some of the ele- 
ments and results in an assembly language source statement. The elements 
of the macro language and model statements are explained fully in the 
following sections, 


Labels 


A macro language label consists of one or two characters, The first must 
be an alphabetic character (A...Z) optionally followed by an alphanume- 
ric character (A,..Z, 0...9). Macro language labels are used to deter- 
mine the sequence of processing of statements in a macro definition 
when the statements are not to be processed in order and have no sig- 
nificance in the actual assembly language. The following are examples 

of valid macro language labels: 


Lt MA aC 


Strings 


The literal strings of the macro language consist of one or more cha- 
racters enclosed in single quotes, and are identical to the character 
strings used in the assembly language. 


An example is 'ONE', 
Another example is 'b' (a blank). 


ia 
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Constants and Operators 


Constants for the macro language are defined the same as constants for 
the assembly language. The arithmetic operators of the assembly lan- 
guage applys also to the macro language. The logical operators and the 
relational operators of SDSMAC also apply to the macro language. 


The macro language permits concatenation of macro variable components 
with literal strings, characters of model statements and other macro 
variables, Concatenation is indicated by writing character strings in 
juxtaposition with string mode references to MACRO variables. 


Variables 


A macro definition may include variables, which are represented in the 
same manner as symbols in the assembler symbol table, with the restric- 
tion that they may be a maximum of two characters in length. 


VA P4 SC F2 AZ 


NOTE 

Macro variables are strictly local; they are available only to 
the macro which defines them. Access to symbols in the AST is 
through the symbol components. 


Parameters 


A parameter is a variable that is an operand of the expanded macro call 
and is declared in the $MACRO statement at the beginning of the macro 
definition, The sequence of parameters in the operand field of the SMACRO 
statement corresponds to the sequence of operands in the operand field 

of the macro instruction. 


Macro Symbol Table 


The macro translator maintains a macro symbol table (MST) similar to 

the symbol table of the assembler, and each entry consists of the string, 
value, length, and attributes of a variable or parameter. The Macro Ex- 
pander module places parameters in the MST as it processes a macro call, 
and places variables in the MST as it processes the macro language state- 
ments that declare variables. 


The string component contains a character string assigned to the macro 
variable or parameter by the macro expander, The value component con- 
tains the binary equivalent of the string component if the string com- 
ponent is an integer. The value component can also contain the value of 
the symbol if the string component is a symbol in the AST. 


The length component contains the number of characters in the string 
component, The attribute components of the MST is similar to the attri- 
bute component of the AST entry in that it is a bit vector, the bits 

of which correspond to the attributes of the variable or parameter. 
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The Macro Expander comprehends the addressing modes of the assembler 
language. The value components contains a binary value which can be 
interpreted if the operand is a valid integer expression of any assem- 
bler addressing mode. 


For example, the statement: 
ADD $MACRO AU, AD 


identifies a macro, ADD, having parameters AU and AD, 


A macro call to activate that macro definition could be coded as follows: 


ADD NUM, *3 


The MST would now contain parameters AU and AD, and string component of 
parameter AU would be 'NUM', The value component would be the value of 
the symbol NUM, and the attribute component would indicate that the 
parameter is supplied in a macro call, The length component would be 3, 
The string component of parameter AD would be '*3', The value compo- 
nent would be 3 expressed as a binary number, and the length component 
would be 2, The attribute component would indicate that the parameter 
is an indirect workspace register address appearing in the macro call. 


Another macro call for the same macro could be coded as follows: 
ADD VAL(5), SUM 


The components of the parameters AU and AD would now correspond to the 
operands of this instruction. The string component of parameter AU 
would be 'VAL(5)', The value component would be 5 (the index register 
number), and the length component would be 6. The attribute component 
would indicate that parameter AU is an indexed memory address appear- 
ing in the macro call instruction. 


The string component of parameter AD would be 'SUM', and the value com- 
ponent would be the value of SUM, The length component would be 3, and 
the attribute component would indicate that parameter AD appears in 

the macro call, 


Each component of a macro variable may be accessed individually. Re- 
ference to a variable is made in either binary mode or string mode. In 
the binary mode, the referenced macro variable component is treated as 
a signed sixteen-bit integer, Binary mode access is made by writing 
the variable name and component. Thus, the binary mode value of the 
length component of AD would be the sixteen bit integer, 3. A refe- 
rence to the string component of a macro variable in binary mode is, 
by definition, the sixteen-bit integer value of the ASCII representa- 
tion of the first two characters of the string. The binary mode value 
of the string component of AD is >5255, which is the ASCII representa- 
tion for 'SU', 
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String mode access of macro variable components is signified by enclo- 
sing the variable in colon characters (:); for example, :AD:. 


NOTE 
Colons are always used in pairs to enclose a variable name, 


The string mode value of a component, other than the string component, 
is the decimal character string whose value is the binary value of the 
component. In the previous example, the string mode value of the length 
component of AD would be the character string '3', If the value of SUM 
were >28, then the string mode value of the value component of AD would 
be the character string '40', which is the decimal equivalent of >28, 
Since the string component of a macro variable is a string, the string 
mode value of a string component is the entire string. 


7.5.4.3 Variable Qualifiers 


The components of a parameter or variable may be specified, using the 
specific names as shown in table 7-1, The variable name is followed by 
a period (.) and the single letter qualifier. The following examples 
show qualified variables: 


AU.S String component of variable AU, 
In the first example of the macro call for a macro 'ADD', AU,S 
equals the binary equivalent for 'NU', or >4E55. If a colon (:) 
has indicated the string mode, the string component is 'NUM' 
(:AU.S: = 'NUM'), 


AU.A Attribute component of variable AU. 
This component may be accessed by use of logical operators and 
keywords, 


AU.V Value component of variable AU, 
In the first example of the macro call for a macro 'ADD', this 
would be the value of the symbol 'NUM' in the AST. 


AU,L Length component of variable AU, 
In the first example of the macro call for a macro 'ADD', AU,L = 3, 


Table 7-1. Variable Qualifiers 


Qualifier Meaning 

S The string component of the variable 

A The attribute component of the variable 
V The value component of the variable 

I. The length component of the variable 
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Except in an SASG statement (described in a subsequent paragraph), an 
unqualified variable means the string component of the variable. In the 
two following examples, the concatenated strings are equivalent: 


:CT.S: b WAY Variable CT qualified, 
:CT: 6 WAY Variable CT unqualified. 


When the string component of a variable is a symbol in the AST, the ad- 
ditional qualifiers of table 7-2 may be used to access the symbol com- 
ponents of that symbol, The symbol components of the parameters of 

macro instructions and the symbol value of an AST symbol are accessible 
directly. To access the other components of a symbol which has not been 
passed as a parameter in the macro definition, the symbol must be as- 
signed as a string component of a macro variable and the symbol compo- 
nent qualifiers of table 7-2 applied to that variable. The following are 
examples of qualified variables that specify symbol components of string 
components of variables: 


B.SS String component of symbol that is the string component of 
variable B, This is null unless a macro instruction has 
caused a string to be associated with by using a SASG 
statement. 


G2. SV Value component of the symbol that is the string component 
of variable G2, If G2.S has been defined as 'MASK', a 
statement MASK EQU>FF has been encountered in the assembly 
language source when G2,SV = >FF, In string mode, :G2.SV: 
= "258". 


NO.SA Attribute component of the symbol that is the string com- 
ponent of variable NO, This component may be accessed by 
use of logical operators and keywords, as described later, 


V2.SL Length component of the symbol that is the string component 
of macro variable V2, If a string has been assigned to the 
symbol which is V2.S, then V2,SL is the length of that 
string. 


NV, SU User attribute component of symbol that is the string com- 
ponent of variable NV, This component is zero except when 
a macro instruction has been issued to set bits in the com- 
ponent with a SASG macro verb, This component is 8 bits 
long and may be used as desired, 


LM. SG Segment component of symbol that is the string component 
of variable LM, 


Concatenation is especially useful when a previously defined string is 
augmented with additional characters. The string 'ONE' could be repre- 
sented by a qualified variable such as CT.S, In that case, concatenation 
expressed as follows: 


:CT.S: "bWAY' 
would provide the same result as writing 
"ONE SWAY' 
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If the qualified variable CT.S represented 'TWO', the result of the 
concatenation in the example would be "TWO WAY', Strings and qualified 
variables may be concatenated as required and the variable need not be 
first. Components of variables that are represented by a binary value 
(e.g., CT.V and CT.L) are converted to their ASCII decimal equivalent 
before concatenation, 


For example: 

:CT.S: 'bWAYb':CT.L: 
is expanded as 

ONE WAY 3 


since the length component of the variable CT is three. 


Table 7-2. Variable Qualifiers for Symbol Components 
Qualifier Meaning 


SS String component of a symbol that is the string component 
of a variable, 


SV Value component of a symbol that is the string component 
of a variable, 


SA Attribute component of a symbol that is the string compo- 
nent of a variable, 


SL Length component of a symbol that is the string component 
of a variable, 


SU User attribute component of a symbol that is the string 
component of a variable, 


SG Segment component of a symbol that is the string component 
of a variable. 


7.5.5 Model Statements 


As mentioned earlier, a macro definition consists of statements that 
contain macro language verbs, and model statements. A model statement 
always results in an assembly language source statement and may consist 
only of an assembly language statement, or portions of an assembly lan- 
guage statement combined with string mode qualified variable components 
using the colon operator (:). In any case, the resulting source state- 
ment must be a legal assembler language statement or errors will result, 
The following examples show model statements: 


MOVB = R6,R7 This model statement is itself an as- 
sembly language source statement that 
contains a machine instruction. 
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:P7.S:bbbSOCbbb:P2.S:,R8bbb:V4.S:This model statement begins with the 
string component of variable P7, 
Three blanks, SOC, and three more 
blanks are concatenated to the string. 
The string component of variable P2 
is concatenated to the result, to 
which, R8 and three blanks are conca- 
tenated, A final concatenation places 
the string component of variable V4 
in the model statement. The result is 
an assembly language machine instruc- 
tion having the label and comment 
fields and part of the operand field 
supplied as string components, 


:MS.S: This model statement is the string 
component of variable MS, Preceeding 
statements in the macro definition 
must place a valid assembly language 
source statement in the string compo- 
nent to prevent assembly errors, 


CAUTION 

Conditional assembly directives may not appear as operations in 
a model statement. Comments supplied in model statement may not 
contain periods (.), since SDSMAC scans comments in the same 
way as model statements and improper use of punctuation may 
cause syntax errors. 


7.5.6 Symbol Attribute Component Keywords 


The macro language recognizes keywords to specify the attributes of as- 
sembler symbols and macro parameters. Each keyword represents a bit po- 
sition within a word that contains all attributes of the symbol or pa- 
rameter, A keyword may be used with a logical operator and the attri- 
bute component to test or set a specific attribute of a symbol or pa- 
rameter, 


The keywords listed in table 7-3 may be used with a logical operator and 
the symbol attribute components (,SA) to test or set the corresponding 
attribute component in both the AST or MST. The following example shows 
an expression that uses a symbol attribute component keyword: 


P5, SA&$STR This is the result of an AND operation 
between the attribute component of the 
symbol that is the string component of 
variable P5 and a bit vector corres- 
ponding to keyword $STR, The expres- 
sion has a nonzero value when the con- 
tents of the string component of P5 
is not null; otherwise, the expression 
has a value of 0. 
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Another example shows an expression that uses a symbol attribute keyword: 


CT. SA++$REL 


Table 7-3, 
Keyword 
$REL 

$REF 

$DEF 

$STR 

$VAL 

$MAC 
$UNDF 


Symbol 


Meaning 


Symbol 
Symbol 
Symbol 
Symbol 
Symbol 
Symbol 
Symbol 


This is the result of an OR operation 
between the attribute component of the 
symbol in the string component of va- 
riable CT and the bit corresponding to 
keyword $REL. The value of the expres- 
sion is that of the attribute component 
showing the symbol as relocatable, 


Attribute Keywords 


is relocatable, 

is an operand of an REF directive, 

is an operand of a DEF directive, 

has been assigned a component string. 
has been assigned a value, 

is defined as a macro name, 


is not defined, 


7.5.7 Parameter Attribute Keywords 


The keywords listed in table 7-4 may be used with a logical operator 
and the macro symbol attribute component to test or set the correspon- 
ding attribute in the MST attribute component. These attribute keywords 
may be used to test or set attributes of both parameters and variables 
in the MST, The following examples show expressions that use parameter 
attribute component keywords: 


P6,A&$PCALL 


RA. A++$PSYM 


This is the result of an AND operation 
between the attribute component of va- 
riable P6 and the bit vector corres- 
ponding to keyword $PCALL, The expres- 
sion has a nonzero value when variable 
P6 is a parameter supplied in a macro 
call, Otherwise the value of the expres- 
sion is zero, 


This is the result of an OR operation 
between the attribute component of 
variable RA and the bit vector cor- 
responding to keyword $PSYM, The va- 
lue of the expression is that of the 
parameter attribute component showing 
the parameter as a symbolic memory ad- 
dress, 
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Table 7-4, Parameter Attribute Keywords 


Keyword Meaning 

$PCALL Parameter appears as a macro-instruction operand, 

$POPL Parameter is an operand list. The value component contains 
the number of operands in the list. 

$PNDX Parameter is an indexed memory address. The value component 
contains the index register number. 

$PIND Parameter is an indirect workspace register address. 

$PATO Parameter is an indirect autoincrement address. 

$PSYM Parameter is a symbolic memory address, 

Verbs 

The macro language supports eleven verbs that are used in macro language 

statements. Any statement in a macro definition that does not contain 

a macro language verb in the operation field is processed as a model 

statement, The verbs and the statements named after all verbs are des- 

cribed in the following paragraphs. 

$MACRO 


Syntax definition: 
<macro name>b...$MACROb... [<parm> ][,<parm>]...6... [<comment>] 


The $MACRO statement must be the first statement of macro definition, 
assigns a name to the macro and declares the parameters for the macro, 
The macro name consists of from one to six alphanumerics characters, 
the first of which must be alphabetic, Each <parm is a parameter for 
the definition, as previously described in paragraph 7.5.4.1. The ope- 
rand field may contain as many parameters as the size of the field al- 
lows, and must contain all parameters used in the macro definition, 
The comment field may not be used if there are no parameters. 


The macro definition is used in the expansion of macro calls that have 
the macro name as an operation code. The syntax for a call is as 
follows: 


<operand> \| [| <operand> 


[<label>] b. . .<macro name>b. . . { | ...b... [<comment>] 
< <operand list> 


operand list> 


When the label field contains a label, the label is assigned to the lo- 
cation of the first object or dummy object code of the expanded macro 
instruction. The macro name specifies the macro definition to be used. 
Each operand may be any expression or address type recognized by the 
assembler or a character string enclosed in quotes. Alternatively, an 
operand list may be used, An operand list is a group of operands en- 
closed in parentheses and separated by commas (when two or more ope- 
rands are in the list) and is processed as a set after removal of the 
outer parentheses during macro expansion. 
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Operands (or operand lists) may be nested in parentheses in the macro 
call for use within macro definitions. 
For example: 

ONE $MACRO P1, P2 
specifies 2 parameters. 
A call such as 

ONE PARI, PAR2 
will result in 

"PARI" being associated with Pl and 'PAR2' being associated with P2. 
However, a call such as 

ONE PAR1, (PAR2, PAR22) 
will result in 


"PAR] being associated with Pl and 'PAR21,PAR22' being associated 
with P2, 


Now if :P2: or :P2.S: is used as an operand in a model statement, it 
has the effect of being two operands (i.e., matching two parameters in 
the macro definition). 


Processing of each macro call in a source program causes the Macro Ex- 
pander to associate the first parameter in the $MACRO statement with 
the first operand or operand list on the macro call line and the se- 
cond parameter with the second operand or operand list, etc. Each pa- 
rameter receiving a value has the $PCALL attribute set. When the macro 
definition has more parameters specified that the number of operands in 
the macro call, the $PCALL attribute is not set for the excess parame- 
ters. The $PCALL attribute is also not set if an operand is null, i.e., 
the call line has two adjacent commas or an operand list of zero ope- 
rands, Expansion of the macro can be conditioned on the number of ope- 
rands by testing this attribute, $PCALL, 


For example, a macro definition containing 
AMAC $MACRO P1, P2, P3 
when called by 
AMAC AB1, AB2 
sets $PCALL in parameters P1 and P2 but not for P3, 
Similarly, 
AMAC XY1,,XY3 
causes $PCALL to be set for Pl and P3 but not for P2, 
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When the macro instruction has more operands than the number of para- 
meters in the $MACRO statement, the excess operands are combined with 
the operand or operand list corresponding to the last parameter to 
form an operand list (or a longer operand list). For example, with the 
macro statement shown, the operands of the two macro calls in the fol- 
lowing code would be assigned to the parameters in the same way: 


ONE EQU 9 

TWO EQU 43 

THREE EQU 86 

FIX SMACRO  P1,P2 MACRO FIX 
FIX ONE,TWO,THREE MACRO-INSTRUCTION 
FIX ONE,(TWO,THREE) MACRO-INSTRUCTION 


Parameters assignments: 


PI.S = ONE P2,S = TWO, THREE 

P1.A = $PCALL P2.A = $PCALL, $POPL 

Pick = 3 PZ. =. 9 

Pl1.V = 9 P2,.V = 2(number of operands in the list) 


Another example of a parameter assignment in a macro statement is as 
follows: 


A EQU 7 

B EQU 15 
GC DATA 17 
D DATA 63 
E EQU 95 
F EQU 47 
G EQU 58 
H EQU 101 
I EQU 119 
PARM 


SMACRO P1,P2,P3,P4,P5,P6,P7,P8,P9 


PARM A,.B,(),C,(D),(E(F),(G,(H.D),*R7+ 
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Parameter assignments: 
PL.S = _A 
P1.A = $PCALL 


PIL = 1 
P1.V = 7 

P3.S = B 

P3.A = $PCALL 
P3.L = 1 

P3.V = 15 
P5.S = C 

P5.A = $PCALL 
P5.L = 1 

P5.V = 0 

P7.S = (E)(F) 


P7.A = $PCALL, $PNDX 
P7,.L = 6 


P7iV = 47 

P9.S = *R7+ 

P9,A = $PCALL,$PATO 
P9.L = 4 

P9.V = 7 

$VAR 


Syntax definition: 
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P2.S 
P2.A 
P2.L 
P2,V 


P4.S 
P4,A 
P4,L 
P4,L 


P6.S 
P6.A 
Pé6.L 
P6.V 


P8.5 
P8.A 
Pe.L. 
P8,V 


(no string) 
(zeroes) 

6) 

6) 


(no string) 
$POPL 

) 

) 


D 
$PCALL, $POPL 
] 
] 


G, (H, I) 
$PCALL, $POPL 
7 

2 


b...$VARD...<var>[,<var> ]...6... [<comment> ] 


The $VAR statement declares the variables for a macro definition. The 
$VAR statement is required only if the macro definition contains one 
or more variables other than parameters. More than one $VAR statement 
may be included and each $VAR statement may declare more than one va- 
riable, Each <var> in the operand is a variable as previously described. 


The following is an example of a SVAR statement: 


$VAR A, CT, V3 


THREE VARIABLES FOR A MACRO 
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The example declares variables A, CT, and V3. A, CT, and V3 must not 
have been declared as parameters. The $VAR statement does not assign 
values to any components of the variables. $VAR statements may appear 
anywhere in the macro definition to which they apply, except that 
each variable must be declared before the first statement that uses 
the variable. It is logical to place $VAR statements immediately fol- 
lowing the $MACRO statement. 


$asc 


Syntax definition: 


b...$ASGb... oe, bTOb var 6... Kcomment> ] 
The $ASG statement assigns values to the components of a variable, 
Variables that are not parameters have no values for components until 
values are assigned using $ASG statements. Components previously as- 
signed to parameters or to variables by $ASG statements may be assigned 
new values with $ASG statements. 


The expression operand may be any expression valid to the assembler, 
and may contain binary mode variable references and the keywords in 
tables 7-3 and 7-4, 


NOTE 

The binary mode value of a string component or symbol string 
component used in an expression is the binary value of the 
first two characters of the string. 


Thus, if GP.S has the string 'LAST', the value used for GP.S in an ex- 
pression is the <string> hexadecimal number >4C41 which is the ASCII 
representation for LA, 


A string may be one or more characters enclosed in single quotes or 
the concatenation of a literal with the string mode value of a quali- 
fied variable, The <VAR> may be either an unqualified variable or a 
qualified variable, 


When the operands are both unqualified variables, all components are 
transferred to target variables, When the source variable is qualified 
or is a quoted string and the destination variable is unqualified, an 
error results, When the destination variable is qualified, only the 
specified component receives the corresponding component of the ex- 
pression or string, with the exception that when a string is assigned 
to the string component of a variable or symbol, the length component 
of that variable or symbol is set to the number of characters in the 
assigned string. If the attribute component of the target variable is 
to be changed, only those attributes which can be tested using keywords 
are changed, Other attributes maintained by SDSMAC may or may not be 
changed, as appropriate. 


NOTE 
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A qualified variable that specifies the length component is 
illegal as the target in a $ASG statement. Also, a qualified 
variable that specifies the attribute component or the value 
component of a macro variable which was declared to be a 
macro language label (for the purpose of a $GOTO) is illegal 
as the target in a $ASG statement. 


The following example show the use of the $ASG statement: 


$ASG P3 TO V3 


$ASG  :P3.S:'ES' TO P3.S 


$ASG  CT.A++$PSYM TO CT.A 


Assign all the components of variable 
P3 to variable V3, 


Concatenate string 'ES' to the string 
component of variable P3, and set the 
string component to the result, Also 
set the length component to a new 
value, 2 greater than the previous 
value. 


Set the bit in the attribute component 
of variable CT to indicate the symbolic 
address attribute, 


Variables P3, V3, and CT must have previously declared, either as para- 
meters in a $MACRO statement or as variables in a $VAR statement. 


The $ASG statement may be used to modify symbol components, as shown 
in the following examples. Assume that P3.V = 6 and P3.S = SUB. 


$ASG  'TEN' TO G,S 


$ASG P3.V TO G.SV 


$ASG 'A':P3.S: 'S' TO G.SS 


Assigns 'TEN' as the string component 
of variable G, When 'TEN' is a label 
in the AST, this statement allows the 
use of symbol component qualifiers to 
modify the components of symbol TEN, 


Sets the value component of the symbol 
in the string component of variable G 
to the value component of variable P3, 
In this case, the value component of 
TEN is set to 6, 


Concatenates string 'A', the string 
component of variable P3 and string S 
and places the result in the string 
component of the symbol in the string 
component of variable G, Also sets the 
length component of the same symbol, 
Thus, the string component of TEN is 
ASUB5 and length component is 5. 
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7.5.12 $NAME 


Syntax definition: 
<label>b...$NAME6... <comment> 


The $NAME statement associates a macro language label with a macro 
language statement. When a label is required for branching within a 
macro definition it must be provided by a $NAME statement. The $NAME 
statement performs no processing in the expansion of a macro in- 
struction. 


The following example shows a $NAME statement: 


AB $NAME BRANCH TO THIS POINT A $GOTO statement with AB as an ope- 
rand branches to this point. 


$ASG P3 TO V3 Expansion of the macro instruction 
continues with the $ASG statement. 


7.5.13 $GOTO 


Syntax definition: 
b...$GOTOb...<label>b... [<comment> ] 


The $GOTO statement branches within a macro definition, either to a 
$NAME statement or to an $END statement, The label is a macro language 
label of either type of statement. 


The following example shows a $GOTO statement: 


$GOTO AB Branch to a $NAME statement having the 
label AB and execute the following 
statement, or to an $END statement 
having the label AB, 
7.5.14 $EXIT 
Syntax definition: 


b, . .$EXITb. oe Kcomment> ] 
The $EXIT statement terminates processing of the macro expansion. The 
$EXIT statement has the same effect as a $GOTO statement with the label 
of the $END statement as the operand. 
7.5.15 $CALL 
Syntax definition: 


b...$CALLb...<macro name>b... Kcomment> ] 


7.5.16 
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The $CALL statement initiates processing of the macro definition named 
in the operand field, The operands passed to the macro being expanded 
are mapped to the parameters of the macro specified in the $CALL 
statement. When the Macro Expander executes a $END statement or a 
$EXIT statement in the called macro, processing returns to the 
statement following the $CALL statement in the calling macro. 


The following is an example of a $CALL statement: 


$CALL CONV Activates the macro definition CONV. 
The parameters of the calling macro 


are passed as the operands of the 
macro CONV, 


SIF 
Syntax definition: 
b...$IFb...<expression>...[<comment>] 


The $IF statement provides conditional processing in a macro definition. 
An $IF statement is followed by a block of macro language statements 
terminated by an $ELSE statement or an $ENDIF statement, When the $ELSE 
statement is used, the $ELSE statement is followed by another block of 
macro language statements terminated by an $ENDIF statement. When the 
expression in the $IF statement has a nonzero value, the block of 
statements following the $IF statement is processed, When the expres- 
sion in the $IF statement has a zero value, the block of statements 
following the $IF statement is skipped. When the $ELSE statement is 
used, and the expression in the $IF statement has a nonzero value, 

the block of statements following the $ELSE statement and terminated 
by the $ENDIF statement is skipped. Thus, the condition of the $IF 
statement may determine whether or not a block of statements is pro- 
cessed, or which of two blocks of statements is processed, Further- 
more, a block may consist of zero or more statements. 


The expression may be any expression as defined for the $ASG statement 
and may include qualified variables and keywords. The expression de- 
fines the condition for the $IF statement. 


NOTE 

The expression is always performed in binary mode. Specifically, 
the relational operators (<, >, =, A=, etc.) operate only on the 
binary mode value of the macro variable. This has the effect 
that comparisons of two character strings may be done only on 
the initial two character positions. 
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The following examples show conditional processing in macro definition: 


Process the statements of Block A when 
the value component of the symbol in 
the string component of variable KY 
contains a nonzero value. Process the 


SIF KY.SV statements of Block B when the compo- 
; . nent contains zero, After processing 
BLOCK A either block of statements, continue 
SELSE processing at the statement following 
. the $ENDIF statement, 
B 
; oe Process the statements of Block A when 
SENDIF the attribute component of parameter T 
SIF T.A&$PCALL=0 indicates that parameter T was not sup- 
: plied in the macro instruction, If pa- 
She A rameter T was supplied, do not process 
SENDIF the statements of Block A, Continue 
processing at the statement following 
SIF T.L=5 the $ENDIF statements in either case. 
BLOCK A Process the statement of Block A when 


the length component of variable T is 
SENDIF equal to 5, If the length component of 
variable is not equal to 5, do not 
process the statements of Block A, Con- 
tinue processing at the statement 
following the SENDIF statement. 


$ELSE 
Syntax definition: 
b...$ELSEb.... [<comment>] 


The $ELSE statement begins an alternate block to be processed if the 
proceding $IF expression was false, 


$ENDIF 
Syntax definition: 
6... $ENDIF6... [<comment>] 


The $ENDIF statement terminates conditional processing initiated by an 
$IF statement in a macro definition, Examples of $ENDIF statements and 
their use are shown in a preceding paragraph. 


$END 
Syntax definition: 
[<label> ]b...$ENDb...<macro name>6... [<comment> ] 


The $END statement marks the end of the group of statements of the 
macro definition named in the operand. When executed, the $END state- 
ment terminates the processing of the macro definition. The label may 
be used in a $GOTO statement to terminate processing of the macro de- 
finition. 
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The following is an example of an $END statement: 


$END FIX Terminates the definition of macro FIX. 


7.6 Assembler Directives To Support Macro Libraries 


7.6.1 


Two directives have been added to support the use of libraries of macros 
in SDSMAC, These two directives are LIBOUT, which is used to build or 
add to a library of macro definition, and LIBIN, which is used to 
"recall" a previously built macro library. 


LIBOUT Directive 


Format: 
...LIBOUTb. . .<LIBRARY-ACCESS-NAME> 


The LIBOUT directive declares a MACRO library where MACRO definitions 
are written during an assembly, The library must have been previously 
created by a CFDIR (create file directory) utility command. MACRO defi- 
nitions appearing in the assembler input stream following a LIBOUT di- 
rective are written to the specified library upon successful transla- 
tion. MACRO definitions appearing prior to the first LIBOUT directive 
remain in memory and are not written to any library. Multiple LIBOUT 
directives may appear in a single assembly. Each successive output li- 
brary supercedes its predecessor so that only one output library is in 
effect at a time, the same library specified on multiple LIBOUT direc- 
tives, Furthermore, a library may be used for both input and output 
simultaneously. MACRO definitions are written to the library using the 
replace option which will redefine any MACRO with the same library 
name, Hence, a macro library may be maintained (updated) without dif- 
ficulty. 


In addition to MACRO definitions, a sub-directory of the MACRO library 
with the name D$DFX$ contains the result of DXOP and DFOP directives 
and MACRO names which redefine an assembly language instruction, direc- 
tive, or pseudo-instruction appearing within the span of the current 
LIBOUT directive. 


The MACRO definitions, DXOPs and DFOPs are written to the library com- 
pletely replacing any prior definitions of the symbols on that MACRO 
library. For example, if a MACRO library contained a MACRO definition 
for the symbol 'LOCK' and a subsequent assembly encounters a 'DFOP 
LOCK, ABS' statement while a LIBOUT directive to that library is in 
effect, the MACRO library will result in containing information that 
"LOCK' is another name for the instruction 'ABS'. The MACRO definition 
which existed on the library previously will have been deleted. 
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LIBIN Directive 
Format: 
b...LIBINb...<_IBRARY-ACCESS-NAME> 


The LIBIN directive declares a MACRO library to be used in the current 
assembly, The library must have been previously created and must con- 
tain only MACRO definitions and DFOP and DXOP directives previously 
encoded during another assembly (by use of the LIBOUT directive). 
Multiple LIBIN directives may appear in a single assembly. When the 
LIBIN directive is encountered the library directory is examined for 
any redefinition of assembler instructions and their existence flagged. 
No further use is made of the MACRO library until an undefined opera- 
tion is encountered, At that time, the MACRO library is searched for a 
possible MACRO definition of the operation. In the case of multiple 
MACRO libraries, the search order is inverse to the order of presenta- 
tion, i.e., the last MACRO library is searched first. The system MACRO 
library specified in the SCI XMA command is always searched last. 


MACRO Library Management 


The MACRO library may be listed, added to, deleted from, and replicated 
using a combination of utility commands provided by the operating sys- 
tem and the MACRO assembler LIBIN and LIBOUT directives. 


To list or replicate a MACRO library, use the utility commands pro- 
vided by the operating system, 


To add to an existing MACRO library or change an existing MACRO defini- 
tion, DFOP, or DXOP, use only the LIBOUT directive provided by the 
MACRO assembler. Do not use utility commands for copying files to copy 
a MACRO definition to another MACRO library. 


To delete MACRO definitions, DFOPs and DXOPs, use the utility commands 
provided by the operating system to delete files. In the following ex- 
amples assume that a MACRO library with the name 


« SYSTEM, MACROS 

is present. 

a. If the result of the DFOP 
DFOP T, TEXT 


is to be deleted, then use the delete file utility command to delete 
the file: 


. SYSTEM, MACROS, D$DFX$.T 
b, If the result of the DXOP 
DXOP SVC, 15 


is to be deleted, use the delete file utility command to delete the 
following file in the same manner as above: 


. SYSTEM, MACROS. D$DFX$, SVC 


Tot 


Ftat 
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c. If a MACRO definition for 'CALL' is to be deleted, use the delete 
file utility command to delete the following file: 


« SYSTEM, MACROS, CALL 


d, If a MACRO definition is to be deleted which redefines an assembly 
language instruction, directive, or pseudo-instruction, then two 
files must be deleted, If the MACRO name were 'TEXT' then delete: 


. SYSTEM, MACROS, TEXT 
« SYSTEM, MACROS. D$DFX$, TEXT 


If only one of these is deleted either an "invalid opcode" assembly 
error will result or the intended macro will not have been used, 


Macro Examples 


Macros may simply substitute a machine instruction for a macro instruc- 
tion, or they may include conditional processing, access the assembler 
symbol table, and employ recursion. Several examples of macro definitions 
are described in the following paragraphs. 


Macro GOSUB 


Macro GOSUB is an example of a macro that substitutes a machine instruc- 
tion for the macro instruction. The macro definition consists of three 
macro language statements, one of which is a model statement, as follows: 


GOSUB $MACRO AD Defines macro GOSUB and declares a parameter, 
AD, 
BL :AD.S: A model statement that results in a BL in- 


struction with the string component of the 
parameter as operand, 


$END GOSUB Terminates macro GOSUB. 


The syntax of the macro instruction for the GOSUB macro is defined as 
follows: 
<label> b...GOSUBb...<address>b...[<comment>] 


When a label is used, it is effectively the label of the resulting BL 
machine instruction, The address may be any address form that is valid 
for a BL instruction. When a comment is used, it applies to the macro 
instruction, For example, the following macro instruction is valid for 
the GOSUB macro: 


GOSUB @ SUBR 


The statement in the example results in a machine instruction to branch 
and link to a subroutine at location SUBR, as follows: 


BL @SUBR 


Another example shows the macro instruction that could be used if the 
subroutine address were in workspace register 8 and had a label, 


NEXIT GOSUB *R8 
The resulting instruction would be: 
NEXIT BL *R8 
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7.7.2 Macro EXIT 


Macro EXIT is an example of a macro that supplies an assembler directive 
the first time the macro is executed, and a machine instruction each 
successive time, The macro requires an EQU directive to be placed in 

the source program prior to calling the macro, and the definition con- 
sists of nine macro language statements, including two model statements. 
The definition is as follows: 


EXIT $MACRO Defines macro EXIT with no parameters, 
$VAR L Defines variable L, 


$ASG 'FI'TOL.S Assign Fl to the string component of va- 
riable L to allow access to symbol Fl in 
assembler symbol table, 


XOP @TERM,15 Model statement - places an XOP machine in- 
struction in source program, 


$IF L.SV If the value component of symbol Fl is a 
nonzero value, perform the next two state- 
ments and terminate the macro. Otherwise, 
terminate the macro, 


TERM BYTE 16 Model statement - places a byte directive 
referenced by the XOP instruction following 
the XOP instruction. 


$ASG OTOL.SV Set the value component of symbol F1 to 
zero. Any further calls to macro EXIT will 
omit the preceding model statement and its 


statement. 
$ENDIF Defines the end of conditional processing. 
$END End of macro definition. 
Fl EQU 1 Defines Fl with a value of 1. This is not 


part of the macro definition, but is a 
source statement, It must precede the first 
macro call for macro EXIT, and may precede 
the definition, 


The syntax of the macro instruction for the EXIT macro is defined as 
follows: 


<label> 6,..EXIT 


When the label is used it is effectively the label of the XOP machine 
instruction resulting from macro. The first time the macro is called, 
the following source statements are placed in program: 


XOP @ TERM, 15 
TERM BYTE 16 
Subsequent calls for the macro result in the following: 


XOP @ TERM, 15 
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7.7.3 Macro ID 


Macro ID is an example of a macro having a default value. The macro 
supplies two DATA directives to the source program. The macro consists 
of nine macro language statements, four of which are model statements. 
The definition is as follows: 


ID $MACRO  ——- WS, PC Defines ID with parameters WS and PC, 


DATA :WS.S: Model statement - places a DATA directive 
with the string of the first parameter as 
the operand in the source program, 


$IF PC.A&$PCALL Tests for presence of parameter PC, 


DATA :PC.S:,15 Model statement - places a DATA directive 
in the source program, The first operand 
is the string of the second parameter, and 
the second operand is 15. This statement 
is processed if the second parameter is 
present, 


$ELSE Start of alternate portion of definition. 


DATA START, 15 Model statement - places a DATA directive 
in the source program, The first operand is 
label START, and the second operand is 15. 
This statement is processed if the second 
parameter is omitted, 


START Model statement - places a label START in 
the source program, This statement is pro- 
cessed if the second parameter is omitted. 


$ENDIF End of conditional processing. 
$END End of macro. 


This macro could be used to place a three-word vector at the beginning 
of a program. The first word could be the workspace address, the second, 
the entry point, and the third, the value 15 to be placed in the SR re- 
gister. The first operand of the macro instruction would be the work- 
space address, and the second operand would be the entry point. When 
the executable code immediately follows the vector, and the entry point 
is the first word of executable code, the second parameter may be omit- 
ted, The syntax definition of the macro instruction for macro ID is as 
follows: 


<label>b...IDb...<address> ,<address> 6...[<comment> ] 


The label becomes the label of the three-word vector, and the addresses 
may be expressions or symbols. 


The following is an example of a macro instruction for macro ID: 
PROG] ID WORK1, BEGIN 
The resulting source code would be: 
PROG] DATA WORK1 
DATA _ BEGIN, 15 
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When the entry point immediately follows the macro instruction, the 
macro instruction could be coded as follows: 


PROG2 ID WORK2 
This would result in the following source code: 
PROG DATA  WORK2 
DATA = START, 15 
START 


This form of the macro instruction imposes two restrictions on the 
source program, The source program may not use the label START and may 
not call macro ID more than once. The user may prevent problems with 
labels supplied in macros by reserving certain characters for use in 
macro-generated labels, A macro definition may maintain a count of the 
number of times it is called, and use this count in each label genera- 
ted by the macro. 


7.7.4 Macro UNIQUE 


0001 IDT ‘UNIQUE’ 

0003 * THIS EXAMPLE DEMONSTRATES A METHOD FOR CREATING UNIQUE 
0004 * LABELS USING THE MACRO LANGUAGE. EACH CALL OF THE MACRO 
0005 * GENERATES A UNIQUE LABEL OF THE FORM ‘U,,xxx’ WHERE'‘xxx’ 
0006 * IS ANUMBER 

0007 LABEL $MACRO 

0008 * DECLARE A VARIABLE TO USE IN THE MACRO 

0009 $VARL 

0010 * ASSIGN THE CHARACTER STRING OF A SYMBOL THAT WILL HOLD 
0011 * A COUNTER VALUE AND THE LAST LABEL GENERATED 

0012 $ASG ‘U;;;: TO L.S 

0013 * INCREMENT THE SYMBOL VALUE OF ‘U::;;;; TO OBTAIN THE 

0014 * LABEL VALUE 

00i5 SASG L. SV+] TO L.SV 

0016 * CREATE THE LABEL AND SAVE IN THE SYMBOL STRING COMPONENT 
0017 * GENERATE THE LABEL IN THE NEXT LABEL FIELD. NOTE THAT 
0018 * MODEL STATEMENT STARTS IN COLUMN 1 

0019 Uiche LSV: 

0020 SEND 

0021 * 

0022 * NOW GENERATE SOME LABELS 

0023 * 

0024 LABEL 


*0001 0000 Uj 
0025 0000 0000 DATA 0, 1 


0002 0001 
0026 LABEL 
*0001 0604 U2 
0027 LABEL 


*0001 0004 U3:3 
0028 0004 0004 DATA 4 
0029 END 
NO ERRORS 
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7.7.5 Macro GENCMT 


Macro GENCMT is an example showing how to implement both those comments 
which appear in the macro definition only, and those comments which 
appear in the expansion of the macro. When this macro is called, the 
statement in line six generates a comment. 


0001 IDT ‘GENCMT’ 
0002 GENCMT SMACRO 
0003 $VAR V 
0004 *THIS IS A MACRO DEFINITION COMMENT 
0005 SASG ‘*’ TO V.S 
0006 :V.S: THIS IS A MACRO EXPANSION COMMENT 
0007 $END 
0008 GENCMT 

*0001 *THIS IS A MACRO EXPANSION COMMENT 
0009 0000 0000 DATA 0,1 

0002 0001 

0010 ; GENCMT 

*0001 *THIS IS A MACRO EXPANSION COMMENT 
0011 GENCMT 

*0001 *THIS IS A MACRO EXPANSION COMMENT 
0012 0004 0004 LABEL DATA 4 
0013 END 


7.7.6 Macro LOAD 


0001 IDT ‘LOAD’ 
0002 * 
0003 * GENERALIZED LOAD IMMEDIATE MACRO 
0004 * 
0005 * THIS MACRO DEMONSTRATES USE OF THE MACRO 
0006 * SYMBOL ATTRIBUTES $PSYM, $PNDX, SPATO, $PIND. 
0007 * 
0008 * OPERANDS: D (DESTINATION) MAY BE REGISTER, 
0009 * INDIRECT, SYMBOLIC, 
0010 * OR AUTO-INC. 
0011 * V (VALUE) SHOULD BE LITERAL VALUE. 
0012 . 
0013 * 
0014 * IF THE FIRST OPERAND IS NOT A REGISTER, IT 
0015 * WILL BE MOVED INTO THE SCRATCH REGISTER 
0016 * BEFORE PERFORMING THE LOAD. THE SCRATCH 
0017 * REGISTER IS ASSUMED TO BE RO. 
0018 : 
0019 . 
0020 * THIS SYMBOL DEFINITION OR’S TOGETHER ALL 
0021 * ADDRESSING MODES BUT ‘REGISTER’. 
0022 . 
0023 001E  COMPLX EQU $PATO++SPSYM++SPNDX++$PIND 
0024 ‘ 
0025 * THIS MACRO WILL MASK OUT THE REGULAR ‘LI’ 
0026 * INSTRUCTION, SO THE ‘DFOP’ FOR ‘LI’ IS 
0027 * USED TO DEFINE A SYNONYM FOR THE ‘LI’ 
0028 * INSTRUCTION. 

* 


0029 


1630/Ass/0281/e 


7/27 


0030 DFOP LIS,LI 
0031 EI $MACRO D,V 
0032 $IF D.A&COMPLX 
0033 LIS... RO,-V: 
0034 MOV RO,:D: 
0035 $ELSE 
0036 LS "sDrv: 
0037 $ENDIF 
0038 SEND 
0039 0000 0000 LOC DATA 0 
0040 EF! *R5,25 
*0001 0002 0200 LIS  R0,25 
0004 0019 
*0002 0006 C540 MOV RO,*RS5 
0041 LI R12.4 
*0001 0008 020C LIS R12,4 
000A 0004 
0042 LI =12(R13),16 
*0001 000C 0200 LI$ RO,16 
OOOE 0010 
*0002 0010 CB40 MOV RO,i2(R13) 
0012 000C 
0043 LI @LOC.111 
*0001 0014 0200 LIS = RO,111 
0016 006F 
*0002 0018 C800 MOV RO,@LOC 
OO1A 0000’ 
0044 * 
0045 * NOTE THAT THE FOLLOWING CASE DOES NOT 
0046 * GENERATE THE DESIRED CODE. TO CORRECTLY 
0047 * DETECT MEMORY LOCATION REFERENCES, LABELS 
0048 * SHOULD HAVE ‘@’ SIGNS PRECEEDING THEM. 
0049 * 
0050 LI LOC,111 
*0001 001C 0200 LI$ LOC,111 
OOIE 006F 
#4ee4424% REGISTER REQUIRED 
0051 END 


0001 ERRORS, LAST ERROR AT 0050 


7.7.7 Macro TABLE 


0001 .IDT ‘TABLE’ 

0002 * 

0003 * THIS MACRO DEMONSTRATES RECURSIVE PROCESSING 
0004 si 

0005 * WHEN MORE OPERANDS ARE PASSED TO A MACRO 
0006 * THAN WERE INCLUDED IN THE DEFINITION. ALL THE 
0007 * SURPLUS OPERANDS ARE ASSIGNED (WITH THE 

0008 * COMMAS BETWEEN THEM) TO THE LAST PARAMETER. 
0009 * THIS IS A USEFUL FEATURE WHEN RECURSIVE PRO- 
0010 * CESSING IS NEEDED. 

0011 * 


46748 


0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 
*0001 
0031 
*0001 
*0001 
*0001 
*0001 
0032 
*0001 
*0001 
*0001 
*0001 
*0001 
0033 
*0001 
*0001 
0034 


0000 


0002 


0004 


0006 


NO ERRORS 


Macro LISTS 


0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 
0011 


0000 


0100 


OOOF 


OOOF 


1111 


* 
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* THE EXPECTED OPERAND FOR THE ‘OR’ MACRO IS A 
* LIST OF BIT PATTERNS 16 BITS IN WIDTH. THIS 

* MACRO USES RECURSION TO ‘OR’ THE BITS 

* TOGETHER. ‘TEMP’ IS A SYMBOL USED BY THE 


* MACRO. 
* 


TEMP 
OR 


EQU 0 
$MACRO A,B 
$VART 
$ASG ‘TEMP’ TO T.S 
$ASG A.V++T.SV TO T.SV 
SIF B.A&$PCALL 
OR :B.S: 
$ELSE 
DATA :T.SV: 
$ASG 0 TO T.SV 
$SENDIF 
$END 
OR >100 
DATA 256 


OR 8 

DATA 15 
OR >11, >1100 

OR >1100 

DATA 4369 
END 


IDT ‘LISTS’ 


* THE PREORD AND ENDORD MACROS DEMONSTRATE 
* RECURSION AND LIST PROCESSING. 


* 
* 
* 


* *# & 


INPUTS: 


A PARENTHESIZED EXPRESSION OF 
THE FOLLOWING FORM: 


A,OP,C 
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0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 

0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 
0031 

0032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 
0040 
0041 

0042 
0043 
0044 
0045 
0046 
0047 
0048 
0049 
0050 
0051 
0052 
0053 
0054 
0955 
0056 
0057 
0058 
0059 
0060 
0061 
0062 
0063 
0064 
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A= PARENTHESIZED EXPRESSION 
OP= OPERATION 
(MULTIPLICATION IS REPRESENTED 
AS A NULL PARAMETER, SIMILAR 
TO ITS REPRESENTATION IN 
ALGEBRAIC EXPRESSIONS) 
B= PARENTHESIZED EXPRESSION 


OUTPUTS: UNPARENTHESIZED EXPRESSION IN 
PREORDER (PREORD), OR ENDORDER 
(ENDORD). 


oR RK KE EE 


* PREORDER MACRO DEFINITION 
* 


* 8 *# HH He HR HH HH HH KH 


PREORD $MACRO A,OP,B 
$VARC VARIABLE TO HOLD‘*’ FOR COMMENTS. 


* 


* PRINT THE OPERATION 
* 


$ASG ‘*’ TOC.S 
SIF OP.A&$PCALL=0 
$ASG ‘*’ TO OP.S 
$ENDIF 
ie: <OP: 
* 


* PRINT THE FIRST OPERAND 
* 


SIF A.A&SPOPL 
PREORD :A: 
$ELSE 


$ENDIF 


* 


* PRINT THE SECOND OPERAND 
* 


SIF BLAA&SPOPL 
PREORD :B: 
$SELSE 


SENDIF 
SEND 


5 oe 2 oo oe oo i a oa ao Ok 


* ENDORDER MACRO DEFINITION 
* 


ENDORD $MACRO A,OP,B 
$VARC VARIABLE TO HOLD ‘*’FOR COMMENTS. 
SASG **’ TOC.S 


* 


* PRINT THE FIRST OPERAND 
* 


SIF A.A&SPOPL 
ENDORD :A: 
SELSE 
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0065 3C> +A: 
0066 SENDIF 
0067 * 
0068 * PRINT THE SECOND OPERAND 
0069 * 
0070 $IF B.A&S$POPL 
0071 ENDORD :B: 
0072 SELSE 
0073 2? <B: 
0074 SENDIF 
0075 * 
0076 * PRINT THE OPERATION 
0077 = : 
0078 $IF OP.A&$PCALL=0 THEN 
0079 $ASG ‘*’ TO OP.S 
0080 $ENDIF 
0081 <C3 OP: 
0082 $END 
0083 > 
0084 * SAMPLE MACRO CALLS 
0085 * 
0086 PREORD A, /, B 
*0001 *. ij 
*0002 *A 
*0003 *B 
0087 ENDORD A, /, B 
*0001 *A 
*0002 *B 
*0003 at | 
0088 PREORD (A, +, B), , (6, /, (2, —, B)) 
*0001 alld 
*0002 PREORD A, +, B 
*0001 = + 
*0002 *A 
*0003 *B 
*0003 PREORD 6, /, (2, —, B) 
*0001 salt | 
*0002 “6 
*0003 PREORD 2, -, B 
*0001 ee 
*0002 a 
*0003 *B 
0089 ENDORD (A, +, B), , (6, /. (2, —, B)) 
*0001 ENDORD A, +, B 
*0001 * A. 
*0002 *B 
*0003 aks 
*0002 ENDORD 6, /, (2, —, B) 
*0001 *6 
*0002 ENDORD 2, -, B 
*0001 2 
*0002 *B 
© os 


*0003 
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*0003 
*0003 

0090 
*0001 
*0002 
*0001 
*0002 
*0001 
*0002 
*0003 
*0003 
*0001 
*0002 
*0003 
*0003 
*0001 
*0002 
*0003 

0091 
*0001 
*0001 
*0001 
*0002 
*0003 
*0002 
*0001 
*0002 
*0003 
*0003 
*0002 
*0001 
*0002 
*0003 
*0003 
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*x / 
/ 
* * 


PREORD ((X, +, Y), /, (X, --, Y)), -, (1, /, Z) 
* 


PREORD (xX, +, Y), /, (X, —, Y) 


=i 
PREORD x, +, Y 
*+ 
ie." 
wy 
PREORD X, -, Y 
= 
+x 
ae 4 
PREORD 1, /, Z 
= 
oat! 
"2 


ENDORD ( (X, +. Y). /, (X, —, Y)), —, (1, /, Z) 
ENDORD (X, +, Y), /, (X, —, Y) 
ENDORD X, +, Y 


*X 
*y 
*+ 
ENDORD X, -, Y 
*X 
*y 
* 
sad | 
ENDORD 1, /, Z 
+] 
*Z 
bia | 


THE FOLLOWING SYMBOLS ARE UNDEFINED 


NO ERRORS 
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SECTION 8 
RELOCATABILITY AND PROGRAM LINKING 


Introduction 


The assembler for the TA 1630 Computer supplies both absolute and relo- 
catable object code that may be linked as required to form executable 

programs from separately assembled modules. This section contains guide- 
lines to assist the user in taking full advantage of these capabilities. 


Relocation Capability 


Relocatable code includes information that allows a loader to place the 
code in any available area of memory. This allows the most efficient use 
of available memory, and is required for disk-resident programs executed 
under TAXO, Absolute code must be loaded into a specified area of memory. 
Absolute code is appropriate for code that must be placed in dedicated 
areas of memory, and may be used for memory-resident programs executing 
under operating systems. 


Object code generated by an assembly is a representation of machine lan- 
guage instructions, addresses, and data comprising the assembled program. 
The code may include absolute segments, program-relocatable segments, a 
data-relocatable segment and numerous common-relocatable segments. In 
assembly language source programs, symbolic references to locations within 
a relocatable segment are called relocatable addresses. The addresses are 
represented in the object code as displacements from the beginning of a 
specified segment. A program-relocatable address, for example, is a dis- 
placement into the program segment. At load time, all program-relocatable 
addresses are adjusted by a value equal to the load address. Data-reloca- 
table addresses are represented by a displacement into the data segment. 
There may be several types of common-relocatable addresses in the same 
program, since distinct common segments may be relocated independently 

of each other. A subsequent section of this manual describes the repre- 
sentation of these relocatable addresses in the object code. 


Relocatability Of Source Statement Elements 


Elements of source statements are expressions, constants, symbols, and 
terms. Terms are absolute in all cases; the other elements may be either 
absolute or relocatable. 


The relocatability of an expression is a function of the relocatability 
of the symbols and constants that make up the expression. An expression 
is relocatable when the number of relocatable symbols or constants added 
to the expression is one greater than the number of relocatable symbols 
or constants subtracted from the expression. (All other valid expressions 
are absolute.) When the first symbol or constant is unsigned, it is con 
sidered to be added to the expression. When a unary minus follows an ad- 
dition operator in an expression, the effective operation is subtraction. 
When a unary minus follows a subtraction operator, the effective operation 
is addition. For example, when all symbols in the following expressions 
are relocatable, the expressions are relocatable: 


LABEL+1 
LABEL+TABLE+INC 
-LABEL+TABLE+INC 


8.3 


8.3.1 


8.3.2 
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Decimal, hexadecimal, and character constants are absolute. Assembly-time 
constants defined by absolute expressions are absolute, and assembly-time 
constants defined by relocatable expressions are relocatable. 


Any symbol that appears in the label field of a source statement other 
than an EQU directive is absolute when the statement is in an absolute 
block of the program. Any symbol that appears in the label field of a 
source statement other than an EQU directive is relocatable when the 
statement is in a relocatable block of the program, 


The relocatability of expressions having logical and relational operators 
follows similar rules to those for expressions containing only arithmetic 
operators. The result of a logical operation between a relocatable con- 
stant or symbol and an absolute constant or symbol is relocatable. A lo- 
gical operation between two relocatable elements of an expression is in- 
valid, Relational operators result in an absolute value, O or 1. The re- 
lation is the assembly-time relation and ignores the effect of relocation 
on relocatable values. 


To summarize, a location is either absolute or relocatable. The location 
may contain either absolute or relocatable values. The example program 
in Appendix J includes absolute locations with relocatable contents and 
relocatable locations with absolute contents. 


Program Linking 


Since the assembler includes directives that generate the information re- 
quired to link program modules, it is not necessary to assemble an entire 
program in the same assembly. A long program may be divided into separately 
assembled modules to avoid a long assembly or to reduce the symbol table 
size. Also, modules common to several programs may be combined as required. 
A linking loader links the programs as it loads them, so that the loaded 
program functions as if it has been assembled in a single assembly. Al- 
ternatively, program modules may be linked by the Link Editor to form a 
linked object module that may be stored on a library and/or loaded as re- 
quired, The following paragraphs define the linking information that 

must be included in a program module. 


External Reference Directives 


Each symbol from another program module must be placed in the operand 

field of an REF or SREF directive in the program module that requires the 
symbol, When the modules are to be linked by the linking loader, the IDT 
character string of each program module that defines one or more of these 
symbols must also be placed in the operand field of an REF directive within 
one of the program modules being linked. The first module may contain an 
REF directive that contains the IDT character strings of all modules to 

be linked. When the modules are to be linked by the Link Editor, IDT cha- 
racter strings need not be placed in REF directive operand fields. 


External Definition Directive 


Each symbol defined in a program module and required by one or more other 
program modules must be placed in the operand field of a DEF directive. 
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8.4 Program Identifier Directive 


8.5 


Program modules that are to be linked by the Link Editor should include 
an IDT directive. The module names in the character strings of the IDT 
directives should be unique. 


Program modules that are to be linked by the linking loader must meet 
the following requirements: 


e Subsequent program modules after the first module must include an IDT 
directive. 


e The first six characters of the IDT character string must be unique 
with respect to the other IDT character strings submitted to the 
loader during the loading operation. 


Linking Program Modules 


The linking loader builds a list of symbols from REF directives as it 
loads the program modules. The loader matches symbols from DEF direc- 
tives to the symbols in the reference list. The loader also matches the 
first six characters of IDT character strings with symbols in the refe- 
rence list. 


When object code for several program modules is on the same device, and 
a program that requires only some of these modules is being loaded, the 
loader ignores those program modules whose IDT character strings do not 
Gppear in the reference list of the loader. This allows program modules 
from several devices to be loaded without requiring the user to locate 
the required modules on the devices. However, it requires that all refe- 
rencing modules precede the modules they reference in the sequence in 
which the loader loads the modules. 


The Link Editor matches symbols from REF directives and symbols from 
DEF directives in a similar manner within a program phase. The Editor 
follows linking commands to determine the modules to be linked, and 
does not match IDT character strings with REF directive operands. Refer 
to paragraphs 4.5.3 and 4.5.4 for linking commands generatable from the 
assembler. 
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SECTION 9 
OPERATION OF THE MACRO ASSEMBLER 


General 


The SDSMAC Macro Assembler executes under the TAXO operating system, 
The Macro Assembler has the following features: 


e Assembles the 72 instructions of the instruction set for the TA 1630 
e Supports 31 assembler directives 

e@ Supports three pseudo-instructions 

e Supports use of parentheses in expressions. 

e Supports logical operators in expressions. 

e Supports relational operators in expressions, 

e Supports a logical division operator. 

e Supports output options. 

e Supports a powerful macro language. 


The Macro processor is defined in detail in Section 7 of this document. 


Operating The Macro Assembler 


The Macro Assembler is executed by the TAXO Sytem Command Interpreter 
(SCI) and may run in either of two modes: 


1. Background 
2. Batch Background. 


To execute the Macro Assembler in background mode, enter the SCI command 
XMA, 


The XMA command prompts for the following parameters: 


SOURCE ACCESS NAME; <access name> 
OBJECT ACCESS NAME; <access name> 
LIST ACCESS NAME: <access name> 
ERROR ACCESS NAME; <access name> 
OPTIONS: <keyword list> 
MACRO LIBRARY PATHNAME: <directory access name> 
PRINT WIDTH: <integer> 
PAGE LENGTH: <integer> 


SOURCE ACCESS NAME specifies the input file or device containing the as- 
sembly language code to be assembled. No default is allowed for this para- 
meter, 


OBJECT ACCESS NAME specifies the output file or device to which the ob- 
ject code is to be written. If this parameter is null, no object output 
is produced. This is useful for preliminary assemblies to check for er- 
rors; since the assembler produces no output, it operates faster. 
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LIST ACCESS NAME specifies the file or device to which the assembly 
listing is to be written. If DUMY is entered, no assembly listing is 
produced. 


ERROR ACCESS NAME specifies the output file to which assembly errors 
are written. This file may be viewed by entering the SF (Show File) SCI 
command, If the ERROR ACCESS NAME is null, or if it is the same as the 
listing file, then errors will be displayed on the terminal by the SBS 
(Show Background Status) SCI command, If the device DUMY is specified, 
no error listing is produced. 


The error file contains a complete list of any source records which 
caused assembly errors along with the errors. If a condition is sensed 
which prevents the assembler from continuing, a message is written to 
the error file as to what has occurred. Then the user must enter the 

SBS (Show Background Status) SCI command to view the error messages out- 
put by the assembler. Table 9-1 contains a list of these abnormal com- 
pletion messages and possible causes. 


Table 9-1. Abnormal Completion Messages 


Message Cause and Recovery 

1/0 Errors 
SOURCE FILE I/0 ERROR, CODE = XXXX The codes are defined in the 
OBJECT FILE I/0 ERROR, CODE = XXXX TA 1630 Error Reporting and 
LIST FILE I/O ERROR, CODE = XXXX Recovery 


TEMP FILE I/O ERROR, CODE = XXXX 
Assembler Bugs 


ATTEMPT TO POP EMPTY STACK - SDSMAC BUG 

DIRECTIVE EXPECTED ~ SDSMAC BUG 

UNEXPECTED END OF PARSE - SDSMAC BUG 

ERROR MAPPING PARSE - SDSMAC BUG 

INVALID OPERATION ENCOUNTERED — SDSMAC 

NO OP CODE - SDSMAC BUG Call a Triumph Adler 
INVALID LISTING ERROR ENCOUNTERED representative. 
SYMBOL TABLE ERROR 

MACRO EXPANSION ERROR 

BUG - INVALID SDSLIB COMMAND ID 

UNKNOWN ERROR PASSED, CODE = XXXX 

END ACTION TAKEN BY MACRO ASSEMBLER 
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OPTIONS specifies any (or all) of the following options: 
XREF - prints a cross reference listing at the end of the listing file. 


RXREF - prints a reduced cross-reference listing at the end of the 
listing file. 


SYMT - includes a symbol table with the output object code. This op- 
tion must be specified to allow fully symbolic debugging. 


TUNLST - Text statement unlist. 
BUNLST - Byte statement unlist. 
DUNLST - Data statement unlist. 
MUNLST - Macro expansion unlist. 

FUNL - Overrides unlist directives. 


TEXT, BYTE, and DATA statements and Macro usage often expand to 
produce multiple lines of code. If these options are selected, 
the statements appear in the listing but the expansion does not. 
For example, the source statement TEXT 'ABCDEF' produces the 
listing: 


41 TEXT 'ABCDEF' 


With the TUNLST option specified, only the line 
41 TEXT ‘ABCDEF' 
is produced in the listing. 
NOLIST - Suppresses all listing output, except to the error file. 


Any of the Option Key words may be abbreviated; for example, any of the 
following may be used for the TUNLST option: 


T 
TU 

TUN 
TUNL 
TUNLS 
TUNLST 


To select more than one option, enter a list of keywords separated by 
commas, The keywords may appear in any order. To select all the options 
one could enter the line: 


OPTIONS: X, S, T, B, D, M 


The options specified for this parameter are in addition to any options 
specified by "OPTION" directives in the source, 


9/4 


MACRO LIBRARY PATHNAME specifies a directory containing macro definitions 
for this assembly. This pathname specification is equivalent to specify- 
ing the same pathname in a LIBIN directive, except that this pathname be- 
comes the system macro library and is retained through the stacked as- 
semblies. This pathname is printed on the cover sheet of the first modul 
only. If this parameter is not specified, no macro library is used. 


PRINT WIDTH specifies the length of the source records written to the 
output file. 


PAGE LENGTH specifies the number of records written to the listing file 
or device between records that contain a form feed character. 


9.2.1 Completion Messages 


A completion message is displayed on the terminal at the first available 
time after the macro assembler has terminated. Table 9-2 contains these 
messages, 


Table 9-2. Completion Messages 


Message Possible Causes and Recovery 
MEMORY REQUIRED EXCEEDS SYSTEM a) Program is too large - break into 
CAPACITY several assembly, modules, take out 


some of the macros or use the LIBIN 
capability, decrease the number of 
symbol definitions. 


b) A macro containing an infinite loop 
or infinite recursion is being ex- 
panded - check all macros. 


c) The assembler itself is in a loop in- 
finitely allocating memory = call a 
TA representative. 


MACRO ASSEMBLY COMPLETE, XXXX ERRORS, YYYY WARNINGS 


ERROR FILE ERROR The error access name specified when 
using the XMA command can not be accessed. 
Verify that the file can be created and 
is not currently open for another program. 
If a null input was entered for this para- 
meter, then there is an SCI problem. 


TCA ERROR The assembly was unable to access the pa- 
rameters specified in the XMA command. 
There is an SCI problem. 


ABNORMAL COMPLETION A condition was sensed which caused the 
assembler to abort. Display the error 
file to get more information and use 
table 9-1 to understand its contents. 


UNABLE TO LOAD OVERLAY Macro assembler has been denied access 
to its overlay file. Check that global 
luno >10 is assigned to a program file. 
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Table 9-2. Completion Messages (Continued) 
Message Possible Causes and Recovery 


TOO MANY REFERENCED SYMBOLS USED Macro assembler has encountered 256 dif- 
ferent externally referenced (REF or 
SREF) symbols in operand fields of in- 
structions or directives that generate 
object code. Reduce this number by 
breaking the program up into several 
modules or by using less REF and SREF 
directives. 


Operating The Assembler In Batch Mode 

Operating the Macro Assembler in batch mode requires two steps: 
1. Prepare the batch command stream, 

2. Execute Batch using the XB command. 
The Batch command stream for macro assembly is depicted in figure 9-1. 
~DATA .MYFILE 

IDT XXXX 

XXXX 

XXXX 

XXXX 

END 


- EOD 
XMA_ S=.MYFILE, L=LPO1 
Q 


Figure 9-1. Macro Assembly Stream 


Any sequential media (e.g. sequential file) may be used for the batch 
stream. 


The parameters for records in a Macro Assembly batch stream are the fol- 
lowing: 


1. .DATA record, This record has the form: 
»DATA <file name> 


The file name must be the name of the sequential file to which the 
input source is to be copied. 


2. .EOD record. This record has the form: 


. EOD 
No parameters are required. The line signifies the end of data to be 
copied, 
NOTE 


If the source file already exists, or is to come from a source 
other than the batch stream then the sequence: 


~DATA 
<Source> 


EOD 
should be omitted from the batch stream, 
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3. XMA record. This record, in addition to specifying macro assembly, also 
supplies the parameters required by the Macro Assembler. Parameters 
are supplied in the following format: 


<keyword or keyword abbreviation> = value. 


For example, to specify a source file .MYFILE, the following charac- 
ters may be used: 


SOURCE =.MYFILE 


Keywords may be abbreviated. Any unambiguous initial segment is accept- 
able. For example: 


S = MYDISC,.MYFILE 
means the same thing as: 
SOURCE = MYDISC.MYFILE 


But O = MYDISC,MYFILEO is not acceptable since 0 could mean OBJECT 
ACCESS NAME or OPTIONS, 


When a keyword takes a list as input, the list should be enclosed in 
parenthesis: 


OPTIONS = (X,T,U) 


Each keyword string must be separated from other keyword strings by a 
comma. For example, the following record assembles a source file named 
«SOURCE, producing an object file .OBJECT, a listing file .LIST, and 
reporting errors to .ERR; the options selected are cross reference 
(XREF) and symbol table (SYMT); no macro library is to be used: 


XMA S = SOURCE, OB = .OBJECT, L =.LIST, E = .ERR, OP = (X,S) 


The only required parameters are SOURCE and LISTING. Other parameters 
may take defaults as indicated in the paragraph on background process- 
ing except that the batch listing file replaces the terminal local 
file as a default output file. 


To execute in batch mode enter the SCI command XB. XB requires two para- 
meters. 


INPUT ACCESS NAME: <sequential device or sequential file name> 
LISTING ACCESS NAME;<file or device name> 


The INPUT ACCESS NAME specifies the batch stream source. The LISTING 
ACCESS NAME specifies a listing file or device. 


Batch mode operation of SCI is defined in detail in the Operator Manuals 
I and II for the TAXO Operating System. 


When the macro assembler is executed in batch mode, the condition codes 
returned by the assembler may be checked. The synonym $$CC contains this 
condition code. The values returned are as follows: 


0 - no errors 

4xxx - assembly errors. The least significant three digits contain the 
error count. 

COOO - the assembly aborted. 


For more information about condition codes, see TA 1630 System Command 
Interpreter. 
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SECTION 10 
ASSEMBLER OUTPUT 


10.1 Introduction 


The assembler for the TA 1630 Computer prints a source listing and pro- 
duces an object file. Optionally, it prints a cross-reference listing 
and includes a symbol table in the object file. 


10.2 Source Listing 


The source listings show the statements and the resulting object code. A 
typical listing is shown with the example program in Appendix J, 


SDSMAC produces a cover sheet as the first output in the listing. This 
cover page contains a table which provides a record of the files and de- 
vices used during the assembly process. An example of this output is as 
follows: 


SDSMAC 
ACCESS NAMES TABLE PAGE 0001 
SOURCE ACCESS NAME = .SSUSAN.SRC.TEST1 
OBJECT ACCESS NAME = 
LISTING ACCESS NAME = SSUSAN.LIST.TEST1 
ERROR ACCESS NAME = : 
OPTIONS = XREF, SYMT, TUNLST, MUNLST 


MACRO LIBRARY PATHNAME = .SDSMAC.MACRODEF 


LINE KEY NAME 
0001 LI .SDSMAC.MACRODEF 
= >. SDSMAC.MACRODEF 
0001 LO MACROS 
= >.SDSMAC.MACRODEF 
0002 A DSC.SYSTEM.TABLES.DOR 
= >DS0O1. SYSTEM.TABLES.DOR 
0003 LI .SDSMAC.MACRODEF 
= >.SDSMAC.MACRODEF 


The output has two sections: 
e A listing of the parameters that were passed to the assembler via SCI. 


e A list of access names encountered during the first pass of the assembly. 


oO 
A 
q 
to) 
~~ 
” 
E-; 
Py 
oO 
te 
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In the first section, any parameters which had no value are left blank. 
The fields in the second section are labeled as follows: 


LINE - This field contains the record number in which the access name 
was encountered. 


KEY - This field contains one of the following: 
LI - indicating a LIBIN usage, 
LO - indicating a LIBOUT usage, 


one character - indicating a copy file to be given this character 
as a key. 


NAME - This field contains two access names. The first name is an image 
of the name on the source record. The second name, appearing 
after the =>, is the result of synonym substitution on the first 
name. 


Each page of the source listing has a title line at the top of the page. 
Any title supplied by a TITL directive is printed on this line, and a 
page number is printed to the right of the title area. The printer skips 
a line below the title line, and prints a line for each source statement 
listed. The line for each source statement contains a source statement 
number, a location counter value, object code assembled, and the source 
statement as entered. When a source statement results in more than one 
word of object code, the assembler prints the location counter value and 
object code on a separate line following the source statement for each 
additional word of object code. The source listing lines for a machine 
instruction source statement are shown in the following example: 


0018 0156 C820 MOV @INIT+3 ,@3 
0158 012B’ 
O1SA 0003 


The source statement number, 0018 in the example, is a four-digit deci- 
mal number. Source records are numbered in the order in which they are 
entered, whether they are listed or not. The TITL, LIST, UNL, and PAGE 
directives are not listed, and source records between a UNL directive 

and a LIST directive are not listed. The difference between source record 
numbers printed indicates how many source records are not listed. 


The next field on a line of the listing contains the location counter 
value, a hexadecimal value. In the example, 0156 is the location counter 
value. Not all directives affect the location counter, and those that do 
not affect the location counter leave this field blank. Specifically, of 
the directives that the assembler lists, the IDT, REF, DEF, DXOP, EQU, 
SREF, LOAD, and END directives leave the location counter field blank. 


The third field normally contains a single blank. However, SDSMAC places 
a dash in this field when warning errors are detected. 
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The fourth field contains the hexadecimal representation of the object 
code placed in the location by the Assembler, C820 in the example. The 
apostrophe following the fourth field of the second line in the example 
indicates that the contents, 012B, is program-relocatable. A quote (") 
in this location would indicate that the location is data-relocatable, 
while a plus (+) would indicate that the label INIT is relocatable with 
respect to a common segment. All machine instructions and the BYTE, 
DATA, and TEXT directives use this field for object code. The EQU di- 
rective places the value corresponding to the label in the object code 
field, 


The fifth field contains the first 60 characters of source statement as 
supplied to the assembler. Spacing in this field is determined by the 
spacing in the source statement. The four fields of source statements 
will be aligned in the listing only when they are aligned in the same 
character positions in the source statements or when tab characters are 
used, 


Error Messages 


The error codes and messages placed in the <:surce listing by the assembler 
are described in the following paragraphs. 


SDSMAC Error Messages 
SDSMAC prints the following error message on successive lines of the 
listing when a error is detected: 


***error description 
LAST ERROR ON STATEMENT XXXX 


The error description is the brief description shown in table 10-1. The 
second line identifies the statement in which the previous error was 
detected. 


At the end of the listing is an error summary, as follows: 
NNNN ERRORS,LAST ERROR ON STATEMENT XXXX, YYYY WARNINGS 


NNNN is the count of errors in the assembly. XXXX identifies the last 
error detected in the assembly. YYYY is the count of the warnings in the 
assembly. The second lines of the error messages link the error messages 
so that the user may begin at the error summary message and readily locate 
all error messages. In an error-free assembly, the final message is: 


NO ERRORS, NO WARNINGS or NO ERRORS, XXXX WARNINGS 
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10.3.2 SDSMAC Warning Messages 


Several errors detected by SDSMAC (such as arithmetic overflow while 
evaluating expressions) are considered to be only warning errors. The 
programmer should examine the code generated when warning messages 
occur, Since the results may or may not be the code expected. Warning 
error messages are written only to the error file and not included in 
the listing. However, a dash is placed in column eleven of the listing 
where the warning error occurred. Warning messages do not include an 
indication of a previous warning or error. 


The following program listing and error file shown in figure 10-1 de- 
monstrate the output of error messages and warnings. 


WARNING 


The dash in column 11 is the only warning indication printed in 
the program listing. If the error file is assigned to a dummy 
device, corresponding warning messages will be lost. 
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ooo1 IDT “WARN* 
0002 * 
0003 * THE NEXT LINE WILL GENERATE BOTH WARNING 
0004 * AND ERROR MESSAGES 
0005 * 
0006 0000-0004" MXLINK XVEC WPOO,PC 
0002 7BC4 
e#eeeeeaeee UNDEFINED SYMBOL 
0007 0000 CSEG “AB 
0008 0000 1234 DATA >1234 
90009 0002 CEND 
0010 * 
0011 0004 WPOO BSS 32 
0012 * 
0013 * THE NEXT LINE WILL GENERTE MULTIPLE WARNING MESSAGES 
0014 * 
0015 0024-0002 "GOGETT DATA >8001#2,>7000#7,>S8001#5 
0026 1000 
0028 0008 
0016 * 
0017 * THE NEXT LINE WILL GENERATE A SINGLE WARNING MESSAGE 
0018 a 
0019 O02A- DEND 
0020 * 
0021 ae THE NEXT LINE WILL GENERATE A SINGLE ERROR MESSAGE 
0022 * : 
0023 002A 1000 JMP @WPOO 


eeeeeeeee DISPLACEMENT TOC BIG 
LAST ERROR AT 0006 
0024 0000 END MXLINK 


THE FOLLOWING SYMBOLS ARE LINTSFINED 


PC 
0002 ERRORS, LAST ERROR AT 0023, 0007 WARNINGS 
0006 0000-0004" MXLINK XVEC WPOO,PC 
0002 7BC4 
Heeeeeeee WORKSPACE ADDRESS NOT FREVIOUSLY DEFINED 
eteeeeeee LINDEFINED SYMBOL 
9015 0024-0002 “GOGETT DATA >S001#2,>7000#7,>8001#5 
0026 1000 
0028 0008 
eeteeeeee VALUE TRUNCATED 
eeeeeneee VALUE TRUNCATED 
Heteeeeee VALUE TRUNCATED 
+Heeeeeeee SYMBOL TRUNCATED 
eeeeeHHHe «INVALID CHARACTER IN SYMBOL- BLANK USED 


0019 OO2A- DEND 
ete = PENDS ASSUMED 
0023 002A 1000 JMP  @WPOO 


eeteeeeee DISPLACEMENT TOO BIG 
THE FOLLOWING SYMBOLS ARE UNLCEFINED 
PC 


0002 ERRORS, LAST ERROR AT 0923, 0007 WARNINGS 


Figure 10-1, Output of Error Messages and Warnings 


Table 10-1. 


Error Message 


$MACRO invalid within 
macro definition. 


Absolute value required. 


Attempt to index by regi- 
ster zero. 


Bad access name syntax, 
"CEND' assumed, 

Close (")"') missing. 
Comma missing. 

Common table overflow. 


Conditional assembly 
nesting error. 


"DEND' assumed. 


Directory open error. 


Directory read error. 


Directory required. 


Directory write error. 


Displacement too big. 


"DSEG' assumed. 
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SDSMAC Listing Errors 


Possible Causes 


a) The $END verb belonging to the previous 
macro was missing. 

b) A $MACRO verb was unintentionally in- 
cluded. 


A warning (Note 1). 


A warning (Note 1). 
A warning (Note 1). 


Too many common segments used (127 maximum). 


An if-then-else construct is in error. Con- 
ditions which could cause this are: 


a) Missing ASMEND'S 
b) Surplus ASMELS'S 
c) Surplus ASMEND'S 


A warning. 


Check that any synonyms are valid and that no 
other processor is currently writing to the 
MACRO Library. 


An I/0 error was encountered while trying to 
read a MACRO Library Directory. Verify that 
no other processor is currently writing to 
that MACRO Library. 


The access name specified is not an existing 
directory. Verify that all synonyms are cor- 
rect and that the MACRO Library does indeed 
exist; it can not be auto-created. 


Verify that no other processor is currently 
writing to that MACRO Library. 


An instruction requiring an operand with a 
fixed upper limit was encountered which over- 
flowed this limit. An example is the 'JMP' 
instruction, whose single operand must eva- 
luate to within >7F words distance from the 
current program counter. 


This is a warning that the following two 
statements have the same result: 


CSEG '$DATA' 
DSEG 
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Table 10-1. 


Error Message 


Duplicate definition. 


Error expanding call. 


Error on copy open. 


Expression syntax error. 


Indirect (*) missing. 


Invalid $ASG variable. 


Invalid character in symbol 


- blank used. 


Invalid CRU or shift value. 


‘Invalid directive in ab- 


solute code, 


Invalid expression. 


Invalid macro expression. 


Invalid macro variable. 


Invalid model statement. 


Invalid opcode. 
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SDSMAC Listing Errors (Continued) 


Possible Cause 


a) The symbol appears more than once in the 
label field of the source. 

b) The symbol appears as an operand of a REF 
statement as well as in the label field 
of the source. 

c) An attempt was made to define a macro 
variable or macro language label which 
was previously defined in the macro. 


The symbol in the operand field of the $CALL 
statement is not a defined Macro, 


The access name specified as the operand of 
copy directive can not be opened. Check that 
the synonyms are correct and that the file 
is not currently being written to by another 
processor, 


a) Unbalanced parentheses. 
b) Invalid operations on relocatable symbols. 


a) An attempt was made to change the length 
component of a variable. 

b) An attempt was made to change the attri- 
bute component or the value component of 
a macro variable which was declared as a 
macro language label. 

c) The target variable is not present or is 
not a symbol. 


A warning (Note 1). The legal characters to 
be used in symbols under SDSMAC are A-Z, 0-9 
1 om Gnd. “S" « 


A warning (Note 1). 


The directives PEND, DEND, CEND have no 
meaning in absolute code, 


May indicate invalid use of a relocatable 
symbol in arithmetic. 


Invalid construct in $ASG statement. 


The target variable specified on a $ASG or’ 
$GOTO verb is not a valid target variable, 


A macro symbol in a model statement must be 
followed with either a colon (:) or end-of- 
record, 


The second field of the source record contained 


an entry that is not a defined instruction, 


directive, psuedo-op, DXOP, DFOP, or Macro name. 
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Table 10-1. | SDSMAC Listing Errors (Continued) 


Error Message 


Invalid option. 


Invalid relocation type. 


Invalid use of condi- 
tional assembly. 


Invalid use of REF'd 
symbol. 


Invalid $ASG expression. 


Invalid $IF expression. 


Label required. 
Macro definition dis- 
carded due to errors. 


MACRO Library read error. 


MACRO Library write error. 


Macro symbol truncated. 


Possible Cause 


A warning (Note 1). The only legal options are: 


FUNL 
(or suitable abbrevation). 


Only PSEG relocatable or absolute symbols 
are allowed as the operand of an 'END' state- 
ment. 


A conditional assembly directive may not ap- 
pear as a model statement. 


The expression is not present. 


The expression either is not present or does 
not evaluate to an integer value. 


$NAME statements must begin with a label of 
maximum length 2. $MACRO statements must begin 
with a label of maximum length 6. 


An error was detected during the assembly of 
the macro definition. Use of the macro name 
in succeeding lines will cause error messages. 


A 'LIBIN' was in effect and the statement was 
a Macro in a specified MACRO Library, but an 
1/0 error was encountered when reading it. 


The current 'LIBOUT' Library could not be 
used at completion of a Macro definition. 
Check that the Macro is not currently being 
written by another processor. 


A warning (Note 1). The maximum length for a 
macro symbol is two chaarcters. The following 
are legal macro symbols: A, A.S, B2.SV. 


The following are illegal macro symbols: CNT, 
CNT.A, PM2.SL. 
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Table 10-1, 


Error Message 


Max macro nesting stack 
depth overflow. 


Memory exceeded. 


Missing $END. 
Model statement truncated. 


Operand conflict PASS1/ 
PASS2. 


Operand missing. 


"PEND' assumed. 
Register required, 
String required. 


String truncated. 
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SDSMAC Listing Errors (Continued) 


Possible Cause 


a) A macro calls itself recursively more than 
the allowed maximum number of times, 

b) More levels of macro calling have been 
used than the allowed maximum, 


The program counter overflowed the value 
>FFFF. 


A warning (Note 1). When expanded, the model 
statement exceeded 80 characters in length. 


The assembler defaults currently undefined 
symbols to register uses in the first pass 
if that symbol is used in an ambiguous way. 
If during the second pass it is discovered 
that the symbol was not a register use, this 
error will result. An example is: 


BL SUB 


SUB EQU $ 


If this has been coded as follows, no am- 
biguity would have existed due to the ex- 
plicit "@" sign: 


BL @ SUB 


SUB EQU $ 


On instructions having a fixed number of ope- 
rands, too few appeared before encountering 

a blank. On instructions having a variable 
number of operands, such as ‘DATA', a comma 
may have been encountered with no operand 
following it. An expression extending beyond 
the 60th column could cause this problem, 


A warning. 


A warning (Note 1). Check the syntax for the 
directive in question to determine the maxi- 
mum length for the string. 


Table 10-1. 


Error Message 


Symbol truncated. 
Symbol required. 


Symbol used in both REF 
and DEF, 


Syntax error. 


‘TO' missing. 
Undefined macro variable. 


Undefined symbol. 


Valid op code required. 


Value truncated. 


Workspace address not 
previously defined. 


$IF - $ELSE - $ENDIF 
construct in error. 


NOTE _1 
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SDSMAC Listing Errors (Continued) 


Possible Cause 


A warning (Note 1). The maximum length for a 
symbol is six characters. 


This is a conflicting, duplicate definition. 


'TO' is a required part of the syntax for 
the $ASG Macro verb. 


The target variable specified on a $ASG or 
$GOTO verb is undefined. 


a) A symbol is used which did not appear in 
the label field of a source record. 

b) The use requires definition in the first 
pass and is undefined when the assembler 
first encounters it. 


The defining symbol (i.e., the second operand) 
is not a valid instruction or directive. 


A warning (Note 1). Overflow is checked after 
every operation in an arithmetic expression. 
This may result in several truncations in one 
expression. 


The operand field must have been previously 
defined. Note that the WPNT directive (or 
implied WPNT) is ignored. Any previous WPNT 
is also ignored from this point on. 


Possible errors are: 


a) Surplus $ELSEs 
b) Surplus $ENDIFs 
c) Missing $ENDIFs. 


Warnings are defined by a dash (-) in column 11 of the assembled 


program listing. 
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10.4 Cross-Reference Listing 


SDSMAC prints an optional cross-reference listing following the source 
listing. The format of the listing is shown in figure 10-2, In the left 
column, the assembler prints each symbol defined or referenced in the 
assembly. In the second column, the attributes of the symbol are indi- 
cated as a list of single characters. The characters that appear in the 
second column, and their meanings, are listed in table 10-2. The third 
column contains a four-digit hexadecimal number, the value assigned to 
the symbol. The number of the statement that defines the symbol appears 
in the fourth column, unless the symbol is undefined. For undefined sym- 
bols, the fourth column is left blank. The right column contains a list 
of the numbers of statements that reference the symbol, or is left blank 
if the symbol is never used. 


CROSS REFERENCE 


LABEL VALUE DEFN REFERENCES 

ADDT 01A8! 0325 0314 

ADSR D o1ao! 0316 0342 0343 0348 0349 
GT 0006 0997 

OBTCHN R 008s 

SQUIB U 0127 0233 


Figure 10-2, Cross-Reference Listing Format 


Table 10-2, Symbol Attributes 


Character Meaning 
R External Reference (REF) 
D External Definition (DEF) 
U Undefined 
M Macro name 
S Secondary Reference (SREF) 
i Force Load (LOAD) 


10.5 
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Object Code 


The assembler produces object code that may be linked to other object 
code modules or programs and loaded into the TA 1630 computer or may 

be loaded into the computer directly. References to the "loader" apply 
to a link editor, linking loader, or loader. Object code consists of 
records containing up to 71 ASCII characters each. The format, describ- 
ed in the next paragraph, permits correction using a keyboard device. 
Re-assembly to correct errors is unnecessary. An example of output code 
is shown in figure 10-3. 


OODOOSAMPROG FO0S4OCOD0ORDOZ OBC OSDBONOEI0N4eC O02 ORO024+BC381 BC OUCH? Fel SF 
AON2SB0241 BOVOOBCB41 B0002B O38 0AG0CAC 00S5e2C 0 0Re2BOCE OC O0SeBOCOOBOF OF 7F 1 DEF 
ROODEBC OR OC O0CAB04C3BC16 0C OGCCCBCIANC OODOBCO72B0281 BSROGRNOECBOE21 7F151F 
ADOEEBOS00B06C1A0OERB1 1 0O2A00F2B05S43B1 1F8Bece 0c 0032BC1 01 BOB44BE 0447F 1 8EF 
AN1LOOBDD66B0003B0282C 00R2B1 1EDB03407F83eF 

200ceo010c 7FCABF 


(A)132255 


Figure 10-3. Object Code Example 


Object Code Format 


The object record consists of a number of tag characters, each followed 
by one to three fields as defined in table 10-3. The first character of 
a record is the first tag character, which tells the loader which field 
or fields follows the tag. The next tag character follows the end of the 
field or fields associated with the preceding tag character. When the 
assembler has no more data for the record, the assembler writes the tag 
character 7 followed by the check sum field, and the tag character F, 
which requires no fields. The assembler then fills the rest of the re- 
cord with blanks and a sequence number, and begins a new record with the 
appropriate tag character. 


Tag character 0 is followed by two fields. Field 1 contains the number 
of bytes of program-relocatable code, and field 2 contains the program 
identifier assigned to the program by an IDT directive. When no IDT di- 
rective is entered, the field contains blanks. The loader uses the pro- 
gram identifier to identify the program, and the number of bytes of pro- 
gram-relocatable code to determine the load bias for the next module or 
program, SDSMAC places a single tag character 0 at the beginning of each 
program, 


The tag character M, used only when data or common segments are defined 
in the program, is followed by three fields. Field 1 contains the length, 
in bytes, of data- or common-relocatable code, Field 2 contains the data 
or common segment identifier, and Field 3 contains a "common number", The 
identifier is a six-character field containing the name $DATAb for data 
segments and $BLANK for blank common segments. If a named common segment 
Gppears in the program, an M tag will appear in the object code with an 
identifier field corresponding to the operand in the defining CSEG di- 
rective(s). Field 3 of the M tag consists of a four-character hexadecimal 
number defining a unique common number to be used by other tags which re- 
ference or initialize data of that particular segment. For data segments, 
this common number is always zero. For common segments (including blank 
common), the common numbers are assigned in increasing order beginning at 
1 and ending with the number of different common segments. The maximum 
number of common segments that a program may contain is 125, 
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Tag characters 1 and 2 are used with entry addresses. Tag character 1 

is used when the entry address is absolute. Tag character 2 is used when 
the entry address is relocatable. Field 1 contains the entry address in 
hexadecimal. One of these tags may appear at the end of the object code 
file. The associated field is used by the loader to determine the entry 
point at which execution starts when the loading is complete. 


Tag characters 3, 4 and X are used for external references. Tag charac- 
ter 3 is used when the last appearance of the symbol in Field 2 of the 

tag is in program-relocatable code. Tag character 4 is used when the last 
appearance of the symbol is in absolute code. The X tag is used when the 
last appearance of the symbol in Field 2 is in data- or common-relocatable 
code. Field 3 of the X tag gives the common numbers. Field 1 of the tag 
characters contains the location of the last appearance of the symbol. 

The symbol in Field 2 is the external reference. Both fields are used 

by the linking loader to provide the desired linking to the external 
reference. 


For each external reference in a program, there is a tag character in 

the object code with a location or an absolute zero, and the symbol that 

is referenced. When Field 1 of the tag character contains absolute zero, 

no location in the program requires the address that corresponds to the 
reference. When Field 1 of the tag character contains a location, the 
address corresponding to the reference is placed by the loader in the 
location specified and the location's previous value is used to point to 
the next location or, if it contains absolute zero, to discontinue linking. 


Table 10-3, TA 1600 Object Tags 


Tag Field 1 Field 2 Field 3 Note 
0 PSEG Length Program ID (8) - 1 
] Absolute Address - - 2 
2 P-R Address a = 2 
3 P-R Address of Chain Symbol (6) . 6 
4 Absolute Address of Chain Symbol (6) - 6 
5 P-R Address Symbol (6) - 5 
6 Absolute Value Symbol (6) = 5 
7 Value ~ - 10 
8 Any Value - - 11 
9 Absolute Address - - 3 
A P-R Address - - 

B Absolute Value - - 

Cc P-R Address - = 

D Absolute Address - - 12 
E Reference Index Number Absolute Offset - 6 
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Table 10-3. TA 1600 Object Tags 


Tag Field 1 Field 2 Field 3 Note 
F si - = 13 
G P-R Address Symbol (6) - 7 
H Absolute Value Symbol (6) - 7 
I P-R Address Program ID (8) - 14 
J D-R/C-R Address Symbol (6) Common# 7 
M DSEG Length $ Data 0000 1 
M Blank Common Length $ Blank Common # 1 
M CSEG Length Common Name(6) Common# 1 
N C-R Address Common # - 4 
P C-R Address Common # - 3 
S D-R Address - - 3 
T D-R Address = = 4 
U 0000 Symbol (6) - 8 
V P-R Address of Chain Symbol (6) - 9 
X D-R/C-R Address of Chain Symbol (6) Common # 6 
W D-R/C-R Address Symbol (6) Common # 5 
¥ Absolute Address of Chain Symbol (6) - 9 
Z D-R/C-R Address of Chain Symbol (6) Common # 9 
Note: 
1 Module Definition 


Entry Point Definition 
3 Load Address 

4 Data 

5 External Definitions 

6 External References 

7 Symbol Definitions 

8 Force External Link 


9 Secondary External Reference 
10 Checksum 
11 Ignore Checksum 


12 Load Bias 
13 End of Record 
14 Module Start Address 


Figure 10-4 illustrates the chain of the external reference EXTR. The ob- 
ject code contains the following tag and fields: 


ACOOEEXTR 
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At location COOE, the address COOA points to the preceding appearance of 
the reference. The chain includes both absolute and relocatable addresses 
and consists of absolute addresses COOE, COOA, C006, and C002, relocatable 
addresses 029E, 029A, and 0298, absolute addresses BOOE, BOOA, BO06, and 
BOO2, and relocatable addresses 0290 and O028E. Each location points to 

the preceding appearance, except for location 028E, which contains zero. 
The zero identifies location O28E as the first appearance of EXTR, the 

end of the chain. 


Tag character E is also used for external references. An E tag is used 
when a non-zero quantity is to be added to a reference. Field 1 identi- 
fies the reference by occurrence in the object code (0, 1, 2, ...). 
Field 2 is the value to be added to the reference after the reference 

is resolved. The value in field 1 is an index into references identified 
by 3, 4, V, X, Y, and Z tags in the object code. The list is maintained 
by order of occurrence, i.e., the first entry in the list is the symbol 
located in field 2 of the first 3, 4, V, X, Y, or Z tag. The index to 
that reference in the E tag would be 0000. 


. DEMONSTRATE EXTERNSL REFERENCE LINEING 
¥ 
REF EXTR 
RORG 
Ca20 MoV @EXTR, SEXTR 
OOOO 
OZSE° 
SRE XOR @EXTR, 3 
SPO? 
; AORG 2 BOOD 
3220 LICK @EXTR, & 
Baz Osvg* 
Ozts Boog 420 BLWF @EXTR 
BOOS Boos 
O2B9 BOOS OZER Al 3, EXTR 
BOOR BAO 
oz40 Bact 3Seao MFY @EXTR, 2 
BOOE BOA 
Oral , RORG ‘ 
O24. Cezo MOY @EXTR, @EXTR 
BOOE 
O278° 
9243 ZeEQ XOR @EXTR, 3 
O29” 
%244 ADRG >COOn 
o245 S229 LOCR SEXTR, & 
GA02Z O0297E" 
9244 CoOo4 9420 BLWF @EXTR 
Cage Cadz 
o247 COCR M225 Al 3, EXTR 
CaAoA CO06 
o24e Coac BeA0 MFY @EXTR,Z 
CO0E COOF 
(A)132256 


Figure 10-4. External Reference Example 
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Tag characters 5, 6, and W are used for external definitions. Tag charac- 
ter 5 is used when the location is program-relocatable. Tag character 6 
is used when the location is absolute. Tag character W is used when the 
location is data- or common-relocatable. The fields are used by the loa- 
der to provide the desired linking to the external definition. Field 2 
contains the symbol of the external definition. Field 3 of tag charac- 
ter W contains the common number. 


Tag character 7 precedes the checksum, which is an error detection word. 
The checksum is formed as the record is being written. It is the two's 
complement of the sum of the 8-bit ASCII values of the characters of the 
record from the first tag of the record through the checksum tag 7. 


Tag characters 9, A, S, and P are used with load addresses for data 
that follows. Tag character 9 is used when the load address is absolute. 
Tag character A is used when the load address is program-relocatable. 
Tag character S is used when the load address is data-relocatable; and 
tag character P is used when the load address is common-relocatable. 
Field 1 contains the address at which the following data word is to be 
loaded. A load address is required for a data word that is to be placed 
in memory at some address other than the next address. The load address 
is used by the loader. Field 2 of tag character P contains the common 
number, 


Tag characters B, C, T, and N are used with data words. Tag character B 
is used when the data is absolute, e.g., an instruction word or a word 
that contains text characters or absolute constants. Tag character C is 
used for a word that contains a program-relocatable address. Tag charac- 
ter T is used for a word that contains a data-relocatable address and 
tag character N is used for a word that contains a common-relocatable 
address, Field 1 contains the data word. The loader places the data word 
in the memory location specified in the preceding load address field or 
in the memory location that follows the preceding data word, Field 2 of 
tag character N contains the common number. 


Tag characters G, H, and J are used when the symbol table option is spe- 
cified. Tag character G is used when the location or value of the symbol 
is program-relocatable, and tag character H is used when the location or 
value of the symbol is absolute. Tag character J is used when the loca- 
tion or value of the symbol is data-or common-relocatable. Field 1 con- 
tains the location or value of the symbol, and Field 2 contains the sym- 
bol to which the location is assigned. Field 3 of tag character J con- 
tains the common number. 


Tag character U is generated by the LOAD directive. The symbol specified 

is treated as if it were the value specified in an INCLUDE command to the 
loader. Field 1 contains zeros. Field 2 contains the symbol for which 

the loader will search for a definition. Refer to the LOAD directive for 

further information. 
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Tag characters V, Y, and Z are used for secondary external references. 
Field 2 contains the symbol that is used as the secondary external re- 
ference. If the last appearance of the symbol is in program-relocatable 
code, a V tag is used. Tag character Y is used when the last appearance 
of the symbol is in absolute code. Tag character Z is used when the last 
Gppearance of the symbol is in data- or common-relocatable code. Field 1 
of these tags contains the location of the last appearance of the sym- 
bol. Field 2 contains the symbol. Field 3 of the Z tag gives the common 
number. These fields are used by the link editor to provide linking to 
the secondary external reference. 


Tag character 8 is used to ignore the checksum. Field 1 contains the 
checksum to be ignored. 


Tag character D is used to specify a load bias. Field 1 contains the 
absolute address which will be used by the loader to relocate the sym- 
bols when loaded. The link editor does not accept the D tag. Tag cha- 
racter D is described in detail in a subsequent paragraph. 


Tag character F indicates the end of record. It may be followed by blanks. 


The last record of an object module has a colon (:) in the first charac- 
ter position of the record, followed by blanks or a time and data iden- 
tifying stamp. 


Machine Language Format 


Some of the data words preceded by tag character B represent machine in- 
structions. Comparing the source listing with the object code fields 
identifies the data words that represent machine instructions. Figure 
10-5 shows the manner in which the bits of the machine instructions re- 
late to the operands in the source statements for each format of machine 
instructions. 
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FORMAT 


x 


(A)132257 


x 1S A BIT OF THE OPERATION CODE THAT IS EITHER 0 OR 1 ACCORDING TO THE 
SPECIFIC INSTRUCTION IN THE FORMAT 


W/B IS A BIT OF THE OPERATION CODE THAT IS 0 IN INSTRUCTIONS THAT OPERATE ON 
WORDS, AND 1 IN INSTRUCTIONS THAT OPERATE ON BYTES 


T IS A PAIR OF BITS THAT SPECIFY THE ADDRESSING MODE OF THE DESTINATION 
OPERAND, AS FOLLOWS 


00 = WORKSPACE REGISTER ADDRESSING 

01 = WORKSPACE REGISTER INDIRECT ADDRESSING 
10 = SYMBOLIC MEMORY ADDRESSING WHEN D = 0 
10 = INDEXED MEMORY ADDRESSING WHEN D #O 


11 WORKSPACE REGISTER INDIRECT AUTOINCREMENT ADDRESSING 


IS THE WORKSPACE REGISTER FOR THE DESTINATION OPERAND 


T IS A PAIR OF BITS THAT SPECIFY THE ADDRESSI!'G MODE OF THE SOURCE OPERAND 
- AS SHOWN FOR Te 

s IS THE WORKSPACE REGISTER FOR THE SOURCE OPERAND 

NUM IS THE NUMBER OF BITS TO BE TRANSFERRED , 

DISP 1S A TWO S COMPLEMENT NUMBER THAT REPRESENTS A DISPLACEMENT 

REG IS A WORKSPACE REGISTER ADDRESS 


COUNT IS A SHIFT COUNT 


M IS A MAP REGISTER FILE NUMBER (0 OR 1) 


Figure 10-5, Machine Instruction Formats 
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Symbol Table 


When the SYMT option is specified, the symbol table is included in the 
object code file. One entry, using tag character G or H as appropriate, 
is supplied for each symbol defined in the assembly. 


Procedures For Changing Object Code 


To correct the object code without reassembling a program, change the 
object code by changing or adding one or more records. One additional 
tag character is recognized by the loader to permit specifying a load 
point. The additional tag character, D, may be used in object records 
changed or added manually. 


Tag character D is followed by a load bias (offset) value. The loader 
uses this value instead of the load bias computed by the loader itself, 
The loader adds the load bias to all relocatable entry addresses, ex- 
ternal references, external definitions, load addresses, and data. The 
effect of the D tag character is to specify the area of memory into 
which the loader loads the program. The tag character D and the asso- 
ciated field must be placed ahead of the object code generated by the 
assembler, 


Correction of the object code may require only changing a character or 

a word in an object code record, The user may duplicate the record up to 
the character or word in error, replace the incorrect data with the cor- 
rect data, and duplicate the remainder of the record up to the 7 tag cha- 
racter. Because the changes the user has made will cause a checksum error 
when the checksum is verified as the record is loaded, the user must 
change the 7 tag character to 8. 


When more extensive changes are required, the user may write an additional 
object code record or records. Begin each record with a tag character 9, 
A, S, or P, followed by an absolute load address or a relocatable load 
address. This may be an address into which an existing object code record 
places a different value. The new value on the new record will override 
the other value when the new record follows the other record in the 
loading sequence. Follow the load address with a tag character B, C, 

T,, or N and an absolute data word or a relocatable data word. Additional 
data words preceded by appropriate tag characters may follow. When addi- 
tional data is to be placed at a non-sequential address, write another 
load address tag character followed by the load address and data words 
preceded by tag characters. When the record is full, or all changes have 
been written, write tag character F to end the record. 
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When additional memory locations are loaded as a result of changes, the 
user must change Field 1 of tag character 0 which contains the number of 
bytes of relocatable code. For example, when the object file written by 
the assembler contained 100016 bytes of relocatable code, and the user 
has added 8 bytes in a new object record, additional memory locations 
will be loaded. The user must find the O tag character in the object 
code file and change the value following the tag character from 1000 to 
1008; he must also change the 7 tag character to 8 in that record. 


When added records place corrected data in locations previously loaded, 
the added records must follow the incorrect records. The loader processes 
the records as they are read from the object medium, and the last record 
that affects a given memory location determines the contents of that 
location at execution time, 


The object code records that contain the external definition fields, the 
external reference fields, the entry address field, and the final pro- 
gram start field must follow all other object records. An additional 
field or record may be added to include reference to a program identi- 
fier. The tag character is 4, and the hexadecimal field contains zeros. 
The second field contains the first six characters of the IDT character 
string. External definitions may be added using tag character 5 or 6 
followed by the relocatable or absolute address, respectively. The se- 
cond field contains the defined symbol, filled to the right with blanks 
when the symbol contains less than six characters, 
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APPENDIX A 


CHARACTER SET 


The TA 1630 assembler recognizes the ASCII characters listed in table A-1. 
The table includes both the ASCII code for each character, represented as 

a hexadecimal value and as a decimal value, and the corresponding Hollerith 
code, The assembler also recognizes the five special characters shown in 
table A-2, In addition the characters shown in table A-3 are accepted if 
they occur within quoted strings or in comment fields. 


The device service routines in the TAXO operating system accept (and 
store in the calling program's buffer) all the characters shown in tables 
A-1, A-2, and A-3. Some device service routines also accept the special 
characters shown in table A-4, Although not accepted by the TA 1630 as- 
sembler, other programs may recognize the characters shown in table A-4 
and perform appropriate action. 


Table A-1. Character Set 


Hexadecimal Decimal Hollerith 

Value Value Character Code 
20 32 Space Blank 
21 33 \ 12-8-7 
22 34 ao 8-7 
23 35 # 8-3 
24 36 $ 11-8-3 
25 37 h 0-8-4 
26 38 & 12 
27 39 ’ 8-5 
28 40 ( 12_8=5 
29 4] ) 11-8-5 
2A 42 * 11-8-4 
2B 43 + 12-8-6 
2C 44 ; 0-8-3 
2D 45 = 11 
2E 46 - 12-8-3 
2F 47 / 0-1 
30 48 0 0 
31 49 1 1 
32 50 2 2 
33 51 3 3 
34 52 4 4 
35 53 5 5 
36 54 6 6 
a7 55 7 7 
38 56 8 8 
39 57 9 9 
3A 58 : 8-2 
3B 59 ; 11-8-6 
3C 60 < 12-8-4 


Table A-1. 


Hexadecimal 
Value 


Table A-2, 


Hexadecimal 
Value 


A/2 


Character Set (Continued) 


Decimal 
Value 


Character 


N< «<x E<CHWNADOVOZZTPACHTOAOAMIODWP?|)yv ti 


Hollerith 
Code 


8-6 
0-8-6 
0-8-7 
8-4 
12-1 
12-2 
12-3 
12-4 
12-5 
12-6 
12-7 
12-8 
12-9 
11-1 
11-2 
11-3 


Additional Special Characters 


Decimal 
Value 


Character 


> uw 


Hollerith 
Code 


12-2-8 
0-2-8 
11-2-8 
11-7-8 
0-5-8 
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Table A-3, Additional Special Characters Recognized by SDSMAC 


Hexadecimal Decimal Hollerith 

Value Value Character Code 
60 96 | 8-1 
61 97 a 12-0-1 
62 98 b 12-0-2 
63 99 c 12-0-3 
64 100 d 12-0-4 
65 101 e 12-0-5 
66 102 f 12-0-6 
67 103 g 12-0-7 
68 104 h 12-0-8 
69 105 7 12-0-9 
6A 106 j 12-1451 
6B 107 k 12=11=2 
6C 108 1 12-11=3 
6D 109 m 12-11-4 
6E 110 n 12-11-5 
6F 111 ° 12-11-6 
70 112 p 12-11-7 
71 113 q 12-11-8 
72 114 r 12-11-9 
73 115 s 11=0=2 
74 116 t 11-0-3 
75 117 U 11-0-4 
76 118 v 11-0-5 
77 119 w 11-0-6 
78 120 x 11-0-7 
79 121 y 11-0-8 
8A 122 z 11-0-9 
7B 123 { 12-0 
7C 124 | 12-11 
7D 125 } 11-0 
7E 126 = 11-0-1 
7F 127 DEL 1269.7 
80 128 11-0-9-8-1 
81 129 0-9-1 
82 130 0-9-2 
83 131 0.9.3 
84 132 0-9-4 
85 133 11-9-5 
86 134 12-9-6 
87 135 11-9-7 
88 136 0-9-8 
89 137 0-9-8-1 
8A 138 0-9-8-2 
8B 139 0-9-8-3 
8C 140 0-9-8-4 
8D 141 12-9-8-1 
8E 142 12-9822 
8F 143 11-9-8-3 


o 
ie Ss 
co 
3 
, 
” 
< 
oS 
oO 
 °) 
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Table A-3. Additional Special Characters Recognized by SDSMAC 


(Continued) 

Hexadecimal Decimal Hollerith 

Value Value Character Code 
90 144 12-11-0-9-8-1 
91 145 9-1 
92 146 11-9-8-2 
93 147 9-3 
94 148 9-4 
95 149 9-5 
96 150 9-6 
97 151 12-9-8 
98 152 9-8 
99 153 9-8-1 
9A 154 9-8-2 
9B 155 9-8-3 
9C 156 12-9-4 
9D 157 11-9=4 
9E 158 9-8-0 
OF 159 11-0-9~1 
AO 160 12-0-9=1 
Al 161 12-0-9-2 
A2 162 12-0-9-3 
A3 163 12-0-9-4 
A4 164 12-0-9-5 
A5 165 12-0-9-6 
A6 166 12-0-9~7 
A7 167 12-0-9-8 
A8 168 12-8-1 
A9 169 12-11-9-1 
AA 170 12-11-9-2 
AB 171 12-11-9-3 
AC 172 12-11-9-4 
AD 173 12-11-9-5 
AE 174 12-11-9-6 
AF 175 12-11-9-7 
BO 176 12-11-9-8 
Bl 177 11-8-1 
B2 178 11-0-9-2 
B3 179 11-0-9-3 
B4 180 11-0-9-4 
B5 181 11-0-9-5 
Bé 182 11-0-9-6 
B7 183 11-0-9~7 
B8 184 11-0-9-8 
B9 185 0-8-1 
BA 186 12110 
BB 187 12-11-0-9-1 
BC 188 12-11=0=9=2 
BD 189 12-11-0-9-3 
BE 190 12-11-0-9-4 
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Table A-3, Additional Special Characters Recognized by SDSMAC 


(Continued) 

Hexadecimal Decimal Hollerith 

Value Value Character Code 
BF 191 12-11-0-9-5 
co 192 12-11-0-9-6 
Cl 193 12-11-0-9-7 
C2 194 12-11-0-9-8 
C3 195 12-0-8-1 
C4 196 12-0-8-2 
C5 197 12-0-8-3 
C6 198 12-0-8-4 
C7 199 12-0-8-5 
C8 200 12-0-8-6 
c9 201 1208.7 
CA 202 12-11-8-1 
CB 203 12511-8=2 
CE 204 12-11-8-3 
cD 205 12-11-8-4 
CE 206 12-11-85 
CF 207 12-11-8-6 
DO 208 12-11-87 
DI 209 11-0-8-1 
D2 210 11-0-8-2 
D3 211 11-0-8-3 
D4 212 11-0-8-4 
D5 213 11-0-8-5 
D6 214 - 11-0-8-6 
D7 215 11-0-8.7 
D8 216 12=11-0-8-] 
D9 217 12211..0=1 
DA 218 2.11 a022 
DB 219 12.-71.20.3 
DC 220 12~11-0=4 
DD 221 12.11=0-5 
DE 222 12-11-0-6 
DF 223 12=11-0=7 
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Table A-4, Additional Characters Recognized by some Device Service 
Routines under TAXO 


Hexadecimal Decimal Hollerith 
Value Value Character Code 
00 0 NUL 12-0-9-8-1 
01 1 SOH 12-9-1 
02 2 STX 12-9-2 
03 3 ETX 12-9-3 
04 4 EOT 9-7 
05 5 ENQ 0-9-8-5 
06 6 ACK 0-9-8-6 
07 Z BEL 0-9-8-7 
08 8 BS 11-9-6 
09 9 HT 12-9-5 
OA 10 LF 0-9-5 
OB 11 VT 12-9-8-3 
oc 12 FF 12-9-8-4 
OD 13 CR 12-9~-8-5 
OE 14 S10) 12-9-8-6 
OF 15 SI 12-9-8-7 
10 16 DLE 12-11-9-8-1 
11 7 DC1 11-9-1 
12 18 DC2 11-9-2 
13 19 DC3 11-9-3 
14 20 DC4 9-8-4 
15 21 NAK 9-8-5 
16 22 SYN 9-2 
17 23 ETB 0-9-6 
18 24 CAN 11-9-8 
19 25 EM 11-9-8-1 
1A 26 SUB 9-8-7 
1B 27 ESC 0-9-7 
1g 28 FS 11-9-8-4 
1D 29 GS 11-9-8-5 
1E 30 RS 11-9-8-6 
1F 31 US 11<9=8.7 


7F 127 DEL 12-9-7 
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APPENDIX B 


INSTRUCTION TABLES 


The source formats for the machine instructions are summarized in eight 
tables. Refer to Section 3 for descriptions of the machine instructions. 
Arithmetic instructions are listed in table B-1, and branch instructions 
are listed in table B-2, Table B-3 lists compare instructions and table 
B-4 lists control and CRU instructions. Load and move instructions are 
listed in table B-5, and logical instructions are listed in table B-6. 
Workspace register shift instruction are listed in table B-7, and the 
extended operation instruction is listed in table B-8. Long distance ad- 
dressing instructions are listed in table B-9. 


The pseudo-instructions are listed in table B-10. 
The following symbols are used in tables B-1 through B-10. 


G, Gl, G2 - A general address in one of the five modes described in Sec- 
tion 3, 


R - A workspace register address. 


S - A symbolic memory address (a label or an expression that contains a 
label or $) 


E - An expression, with the additional limitation that the expression 
must not contain a symbol that is not previously defined. 


I - An immediate value, which is an expression. 

T -A term, 

M —- Memory map file, O or 1. 

(,) - The contents of the address within parentheses. 
— - "replaces" 

: - "is compared to" 


The following example shows the use of the symbols in the source format 
column: 


XOR G,R 


The source format entry means that the mnemonic operation code XOR re- 

quires a general address and a workspace register address separated by 

a comma, In the effect column, the symbols are used as in the following 
example: 


(G) XOR (R) ~ (R) 


This means that the result of an exclusive OR of the contents of the ge- 
neral address with the contents of the workspace register replaces the 
contents of the workspace register. In the status bits test column, the 
symbols are used as in the following example: 


(R) : 0 


This means that the result placed in the workspace register is compared 
to zero and the status bits contain the result of this comparison. 
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Table B-1. Arithmetic Instructions 


Status Bits Status Bits Format 
Instruction Format Effect Opcode Affected Test Number 
Add words A Gl, G2 (G1)+(G2)>(G2) A000 0-4 (G2) :0 I 
Add bytes AB G1, G2 (G1)+(G2)>(G2) BOOO 0-5 (G2) :0 I 
Absolute value ABS G Absolute (G)-(G) 0740 0-2,4 Note 1 VI 
Add immediate AIR, I (R)+I>(R) 0220 0-4 (R) :0 VIII 
Decrement DEC G (G)-1>(G) 0600 0-4 (G) :0 VI 
Decrement by 2 DECTG (G)-2>(G) 0640 0-4 (G) :0 VI 
Divide DIV G,R Note 2 3C00 4 Note 3 Ix 
Increment INC G (G)+1-+(G) 0580 0-4 (G) :0 VI 
Increment by 2 INCTG (G)+2-(G) 05CO 0-4 (G) :0 VI 
Multiply MPY G,R Note 4 3800 None IX 
Negate NEG G (G)+(G) 0500 0-2,4 (G) :0 VI 
Subtract $ G1, G2 (G2)}(G1) (G2) 6000 0-4 (G2) :0 I 
Subtract Bytes SB G1, G2 (G2)-(G1)>(G2) 7000 0-5 (G2) :0 I 
NOTES: 
1, The original value of G is compared to zero. 


2 


The contents of register R and the next consecutive register (32-bit 
magnitude) are divided by G (16-bit magnitude). The quotient (16-bit 
magnitude) is placed in R and the remainder is placed R+]. If R=15, 

the remainder is placed in the location immediately following the work- 
space, 


If the divisor is less than or equal to the left half of the dividend, 
the divide instruction is aborted and overflow status bit (bit 4) is 
set. 


(G) is multiplied by (R). The result (32-bit magnitude) is placed in 

R and R+1. R contains the most significant half of the result. If R=15, 
the least significant half of the result if placed in the location im- 
mediately following the workspace. 
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Table B-2, Branch Instructions 


Format 
Instruction Format Effect Necessary Status Opcode Number 
Branch BG G > (PC) Unconditional 0440 VI 
Branch and Link BLG G-> (PC) Unconditional 0680 VI 
(PC) > (R11) 
Branch and Link WP BLWP G Note | Unconditional 0400 VI 
Jump If Equal JEQ S S>(C) Bit 2=1 1300 II 
Jump If High or Equal JHE S S > (PC) Bit O or Bit 2 = 1 1400 ll 
Jump If Greater Than JGT § S> (PC) Bit 1 =1 1500 II 
Jump If Logical High JH S S > (PC) Bit 0 = 1 and 1B00 II 
Bit 2=0 
Jump If Logical Low JLS S > (PC) Bit 0 = 0 and 1A00 Il 
Bit2=0 
Jump If Less or Equal JLE S S > (PC) Bit 1 = 0 and 1200 I 
Bit2=1 
Jump If Less Than JLT S S > (PC) Bit 1 = 0 and 1100 Ul 
Bit2=0 
Unconditional Jump JMP S S > (PC) Unconditional 1000 II 
Jump If No Carry JNC S S > (PC) Bit3=0 1700 I 
Jump If Not Equal JNE S S > (PC) Bit 2=0 1600 II 
Jump If No Overflow JNO'S S > (PC) Bit 4=0 1900 Il 
Jump If Odd Parity JOP S SC) Bit 5 =1 1C00 Il 
Jump On Carry JOC S S > (PC) Bit 3 = 1 1800 II 
Return WP RTWP Note 2 Unconditional 0380 VII 
Execute XG Note 3 Unconditional 0480 VI 
NOTES; 
1. BLWP is explained in detail in paragraph 8.2, {it can be summarized as 
follows: 
(G) — (WP) (old PC) ~ (R14) 
(G + 2) + (PC) (ST) (R15) 


(original WP) — (R13) 


2. RTWP is explained in detail in paragraph 8.2. It can be summarized as 
follows: 


(R13) — (WP) 
(R14) — (PC) 
(R15) — (ST) 


3. An instruction at address G is executed as if it were located in memory 
where the Execute instruction resides. Observe that if the instruction 
executed is not a single word instruction, the word following the 
Execute instruction is used (i.e., if symbolic memory addressing or 
indexed addressing is required, the symbol value must be in the word 
following the Execute instruction). The Execute instruction does not 
affect the status bits but the instruction executed will set the status 
bits appropriately, 
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Table B-3. Compare Instructions 


Status Bits Status Bits Format 

Instruction Format Opcode Affected Test Number 
Compare Words C Gl, G2 8000 0-2 (G1) :(G2) I 
Compare Bytes CB Gl, G2 9000 0-2, 5 (G1) :(G2) I 
Compare Immediate CIR,I 0280 0-2 (R) :I Vul 
Compare Ones COCG,R 2000 2 Note 1 Ill 
Corresponding 
Compare Zeros CZCG,R 2400 2 Note 2 ll 
Corresponding 
NOTES: 


General: Compare instructions have no effect other than setting status 
bits. Note that the two's complement representation negative 
numbers are logically greater than positive numbers,’and that 
negative numbers of small magnitude are logically greater than 
negative numbers of larger magnitude. 


1. The bits in the destination operand that correspond to bits equal to 
one in the source operand are compared to one. If the corresponding 
bits are equal to one, status bit 2 is set to 1. Otherwise the status 
bit is set to 0, 


2. The bits in the destination operand that correspond to bits equal to 
one in the source operand are compared to zero. If the corresponding 
bits are equal to zero, status bit 2 is set to 1. Otherwise the status 
bit is set to 0. 
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Table B-4, Control and CRU Instructions 


Status Bits Status Bits Format 

Instruction Format Effect Opcode Affected Test Number 
Clock Off CKOF Note 1 03C0 None VII 
Clock On CKON Note 2 03A0 None Vil 
Load Communication LDCR G, T Note 3 3000 0s255 (G) :0 IV 
Register 
Idle IDLE Note 4 0340 None VII 
Load ROM and Execute LREX Note 6 03E0 None Vu 
Reset I/O RSET Note 5 0360 0-5 Note 7 VII 
Set Bit to One SBO E Note 8 1D00 None II 
Set Bit to Zero SBZ E Note 9 1E00 None I 
Store Communication STCR G, T Note 10 3400 0-2,5 (G) :0 IV 
Register 
Test Bit TBE 1F00 2 Note 11 Il 
NOTES; 


1 
ie 


3% 


4, 
6, 
Ts 
8, 

: 10. 

> 

Q 

ie) 

< 

S$ 11. 

m4 


Disables 120 Hz clock. 


Enables 120 Hz clock. If interrupt level 5 is enabled, an interrupt 
occurs every 8,33 ms, Interrupt address is 14),¢. 


Transfers consecutive data bits from the byte address specified by G 
to the CRU. The number of bits to be transferred is specified by T. 
The CRU address is the contents of R12 of the current workspace, The 
least significant bit of the byte address specified by G is placed in 
the CRU bit addressed by R12, See illustration, Memory CRU Transfer 
(Note 9). 


Places the computer in the idle state. An interrupt or start sigral 
causes the computer to resume execution at the instruction following 
the IDLE instruction. 


Disables al] interrupts. Resets all directly connected I/0 devices. 


Places contents of FFFC)¢ into WP register, and contents of FFFE)¢ 
into PC, 


Sets bits O - 5 to zero. 
Sets CRU bit at address in R12 + E to one, 
Sets CRU bit at address in R12 + E to zero. 


Transfers consecutive data bits from the CRU to the byte address spe- 
cified by G. The number of bits transferred is specified by T. The 
CRU address is the contents of R12 of the current workspace. The CRU 
bit addressed by R12 is placed in the least significant bit of the 
byte addressed by G, See Memory - CRU Transfer illustration. 


Tests CRU bit at address in R12 + E, Set status bit 2 to the value of 
the CRU bit. 


(A)128444 
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Memory - CRU Transfer 


Table B-5. Load and Move Instructions 


Status Bits Status Bits Format 


Instruction Format Effect Opcode Affected Test Format 
Load Iinuediate LI R,I 1 > (R) 0200 0-2 1:0 Vill 
Load Interrupi Mask L IMI I Note 1 0300 None Vill 
Load Memory Map File LMF R,M Notes 4 0320 None X 
Load Workspace Pointer LWPI I I > (WP) 02E0 None VIL 
Move Words MOV G1, G2 (G1) > (G2) C000 0-2 (G2) :0 I 
Move Bytes MOVB G1, G2 (G1) > (G2) DOo00 0-2,5 (G2) :0 I 
Store Status STST R (ST) > (R) 02C0 None Vill 
Store WP STWP R (WP) > (R) 02A0 None Vill 
Swap Bytes SWPB G Note 3 06CO None VI 
NOTES: 


1. 


2s 


Places the least-significant 4 bits of the immediate value I in the 
interrupt mask, 
Loads the 256 words of the ROM program into the first 256 words of me- 


mory. Places the contents of the memory pair at address 0 into WP and 
PC and starts execution. 


Interchanges bits 0 - 7 with bits 8 - 15 of word at address specified 
by G. 


Place the contents of a six-word area at the address in R into memory 
map file M. 
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Table B-6. Logical Instructions 


Status Bits Status Bits Format 


Instruction Format Effect Opcode Affected Test Number 
AND Immediate ANDI R, I (R) AND I > (R) 0240 0-2 (R) :0 Vil 
Clear CLRG 0->(G) 04C0 None VI 
Invert Bits INV G Note 1 0540 0-2 (G) :0 VI 
OR Immediate ORI R, I (R) ORI > (R) 0260 0-2 (R) :0 Vill 
Set to Ones SETO G >FFFF > (G) 0700 None VI 
Set Ones Corresponding SOC G1,G2 Note 2 E000 0-2 (G2) :0 I 
Set Ones Corresponding SOCB G1,G2_ Note 2 FOOO 0-2,5 (G2) :0 I 
Bytes 
Set Zeros Corresponding SZC G1,G2 = Note 3 4000 0-2 (G2) :0 I 
Set Zeros Corresponding SZCB G1,G2_ Note 3 5000 0-2,5 (G2) :0 I 
Bytes 
Exclusive OR XORG,R (G) XOR (R) >(R) 2800 0-2 (R) :0 Il 
NOTES: 


1. Places one's complement of contents of location G in location G, 


2. Sets bits to one in G2 that correspond to bits equal to one in Gl. 
(G1) OR (G2) ~ (G2). 


1111111100000000 GI 
LG@1lO1O1TO161016216 G2 
117111111110101010 G2 (result) 


3. Sets bits to zero in G2 that correspond to bits equal to one in Gl. 
(INV (G1)) AND (G2) — (G2). 


1111111100000000 Gl 
19010101 01'0 TO 1T'O7T 6” G2 
0000000010101010 G2 (result) 


a 
Ss 
0 
8 
? 
“ 
o 
oO 
» °) 
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Table B-7. Workspace Register Shift Instructions 


Boia ea Value Placed gape Bit Position on Format 
ift Opcode Number 
Shift Right Arithmetic SRA R,C Original value of leftmost bit 0800 Vv 
Shift Right Logical SRL R,C Logical zero 0900 Vv 
Shift Left Arithmetic SLA R,C Logical zero (Note 1) 0A00 Vv 
Shift Right Circular SRC R,C Rightmost bit moves to leftmost bit OBOO Vv 


NOTES: 


General: If C is zero, the 4 least-significant bits of RO contain the 
shift value. If the 4 least-significant bits of RO equal 0, 
shift 16 positions. Otherwise shift C positions. The value of 
the last bit shifted out of the register is placed in status 
bit 3. The shifted value is compared to zero-setting status 
bits 0 - 2, 


1. If the sign of the value in R changes during shift, sets status bit 4. 


Table B-8, Extended Operation Instruction 


Status Bits Status Bits Format 
Instruction Format Effect Opcode Affected Test Number 
Extended Operation XOP G, T Note 1 2C00 6 Note 2 IX 


NOTES: 
1. T specifies the extended operation, 0 - 15, to be executed. 


2. Sets status bit 16 to one when extended operation is software imple- 
mented, and to zero when extended operation is hardware implemented. 


Table B-9,. Long Distance Addressing Instructions 


Status Bits Status Bits Format 

Instruction Format Effect Opcode Affected Test Number 
Long Distance Source LDS G Note 1 0780 None VI 
Long Distance LDDG_~ Note 2 0700 None VI 


NOTES; 


1. Places the contents of a six-word area of memory at G into memory map 
file 2, to use for source address of following instruction. 


2. Places the contents of a six-word area of memory at G into memory map 
file 2, to use for destination address of following instruction. 
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Instruction 
NOP 

RT 

XVEC 
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Pseudo-Instructions 


Equivalent 
Instruction 


IMP $ + 2 
B *11 
DATA, DATA, WPNT 


Opcode 
1000 
045B 
N.A, 
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PROGRAM ORGANIZATION 


Program Areas 


There are three types of areas in a program for the TA 1630 Computer. 
These are the procedure, the workspace, and the data areas. The proce- 
dure area contains the computer instructions. The workspace area contains 
program linkage, high activity data, and addresses. As many workspaces 

as convenient may be allocated for a program. Data areas may be allocated 
as required, 


The three previously described hardware registers = WP, PC, and ST - con- 
trol program execution. The workspace pointer contains the address of the 
first word of a 16-word area of memory called the workspace. Note that 
the program workspace may be changed by changing the contents of the WP 
register. The PC contains the address of the next instruction to execute. 
The status register contains condition bits set by instructions already 
performed and the interrupt level mask. These three registers then, com- 
pletely control and define the context of a program, 


The general environment of the TA 1630 Computers is shown in figure C-1. 
This arrangement of workspace,procedure,and data is the simplest approach 
to TA 1630 programming. However, though many application programs may be 
written in this manner, a more segregated approach, with possibly several 
workspaces, data areas, and connected simple procedures, would provide 
increased flexibility and applicability. 


Most of the programs execute in the environment provided by a resident 
executive. The areas may be combined in a single task, or the workspace 
and data areas may be combined in the data division of the task. The 
procedure area becomes the procedure division of the task in that case. 
The TAXO executive supports writing a procedure division to be used 
with several data divisions to form tasks that perform the same func- 
tions on several sets of data. Refer to the user's guide of the TAXO 
executive for information about the envionment it provides for user 
programs. 


Procedure 


A procedure is the main body of a program and contains computer instruc- 
tions. It is the action part of a program. Procedures could be coded to 
solve an equation, run a motor, determine status of a process, or condi- 
tion a set of data that is to be processed by another procedure. Proce- 
dures in the TA 1630 Computers may have workspaces and data as an inte- 
gral part of the coding or may use workspaces and data passed from another 
procedure, 
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C.3 Workspace 


The TA 1630 Computers use workspaces that may be anywhere in memory and 
that consist of sixteen consecutive memory words. A context switch due 
to an interrupt, an XOP instruction, or a BLWP instruction changes the 
active workspace. A return from the subroutine provided for either of 
these context switches using an RTWP instruction restores the original 
workspace. Execution of an LWPI instruction makes a specified workspace 
active without changing the PC contents. When the data division is sepa- 
rate from the procedure division, any workspace that contains data that 
is unique to the task represented by the data division should be a part 
of the data division. 


MEM ORY MEMORY 


ADDRESS MEMORY 
HARDWARE REGISTERS 


" i —— — 


0102 WRI 


™ Ce 1 oe as 


| 
| 
| 
| 
| 
| o11c WRI4 
| 
| O11E WRIS: 
| 
| 
| 
| a ase PROGRAM 
| O21E (INSTRUCTION IN EXECUTION) PROCEDURE 
nd 0220 (NEXT INSTRUCTION) AREA 
: CONTAINING 
MACHINE 
o4co INSTRUCTIONS 
1000 PROGRAM 
1120 DATA AREA 
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Figure C-1. TA 1630 Computer Programming Environment 
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C.4 Data 


Data for a procedure may appear in many forms. In assembly language, there 
are three directives available to the programmer to initialize data within 
a program module. These directives are: 


e DATA - Initializes one or more consecutive words of memory to specific 
values that are input on this statement. 


e BYTE - Initializes one or more consecutive bytes of memory as does 
the DATA statement, except that bytes are initialized. 


e TEXT - Initializes a textual string of characters in consecutive 
bytes of memory. The characters are represented in USASCII code. 


Also, data input from the data terminal or device attached to the CRU or 
TILINE is available to procedures in the TA 1630 Computer. 


The TAXO executive for the TA 1630 Computer supports the user pro- 

grams by executing supervisor calls to perform input and output opera- 
tions, data conversions, and other functions. The user provides data in 
required formats for supervisor call blocks that define the supervisor 
call, and for other data blocks as appropriate. The assembler directives 
described previously may be used to provide this data. Details of the 
data requirements for interface with an executive are described in the 
user's guide for the executive. 
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HEXADECIMAL INSTRUCTION TABLE 


Hexadecimal Mnemonic 


Operation Operation 
Code Code Name Format Paragraph 
0200 LI Load Immediate VIII 3.60 
0220 AI Add Immediate VIII 3.12 
0240 ANDI AND Immediate VIII 3.70 
0260 ORI OR Immediate VIII 3.71 
0280 CI Compare Immediate VIII 3.45 
02A0 STWP Store Workspace Pointer VIII 3.68 
02CO STST Store Status VIII 3.67 
02E0 LWPI Eaad Workspace Pointer VIII 3.62 
Immediate 
0300 LIMI Load Interrupt Mask VIII 3.61 
Immediate 
0320 LMF Load Memory Map File X 3.63 
0340 IDLE Computer Idle VII 3.50 
0360 RSET Computer Reset VII 3.49 
0380 RTWP Return From Interrupt VII Bna7 
Subroutine 
030A CKON Clock On VII 3.52 
03CO CKOF Clock Off VII 3.51 
O3E0 LREX Load ROM and Execute VII 3.53 
0400 BLWP Branch And Load Workspace VI 3.26 
Pointer 
0440 B Branch VI 3,24 
0480 X Execute VI 3.41 
04CO CLR Clear Operand VI 3.74 
0500 NEG Negate VI 3,22 
0540 INV Invert VI 3.73 
0580 INC Increment By One VI 3517 
05CO INCT Increment By Two VI 3.18 
0600 DEC Decrement By One VI 3.14 
0640 DECT Decrement By Two VI 3.20 
0680 BL Branch and Link VI 3.25 
06CO SWPB Swap Bytew VI 3.66 
0700 SETO Set Ones VI 3.75 
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HEXADECIMAL INSTRUCTION TABLE (Continued) 


Hexadecimal 
Operation 
Code 


0740 
0780 
07C0 
0800 
0900 
OAO00 
OBOO 
1000 
1100 
1200 
1300 
1400 
1500 
1600 
1700 
1800 
1900 
1A00 
1B00 
1C00 
1D00 
1E00 
1FO00 
2000 
2400 
2800 
2C00 
3000 
3400 


3800 
3C00 


Mnemonic 

Operation 

Code Name 

ABS Absolute Value 

LDS Long Distance Source 

LDD Long Distance Destination 

SRA Shift Right Arithmetic 

SRL Shift Right Logical 

SLA Shift Left Arithmetic 

SRC Shift Right Circular 

JMP Jump Unconditional 

JLT Jump Less Than 

JLE Jump Low Or Equal 

JEQ Jump Equal 

JHE Jump High Or Equal 

JGT Jump Greater Than 

JNE Jump Not Equal 

JNC Jump No Carry 

JOC Jump On Carry 

JNO Jump No Overflow 

JL Jump Low 

JH Jump High 

JOP Jump Odd Parity 

SBO Set Bit To One 

SBZ Set Bit To Zero 

TB Test Bit 

coc Compare Ones Corresponding 

CZC Compare Zeros Corresponding 

XOR Exclusive OR 

XOP Extended Operation 

LDCR Load Communication Register 

STCR Store Communication 
Register 

MPY Multiply 


DIV Divide 


Format 
VI 
VI 
VI 


II 
II 
II 
II 
II 
II 
II 
i 
II 
IT 
II 
II 
II 
II 
II 
II 
III 
III 
III 
IX 
IV 
IV 


IX 
IX 


Paragraph 


3.21 
3,87 
3.88 
3.81 
3.83 
3,82 
3.84 
3.28 
3.34 
3.32 
3.35 
3.31 
3.33 
3.36 
3.38 
3.37 
3.39 
3.30 
3.29 
3.40 
3.54 
3.55 
3.56 
3.46 
3.47 
3.72 
3.85 
3.57 
3.58 


3.15 
3.16 
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HEXADECIMAL INSTRUCTION TABLE (Continued) 


Hexadecimal 
Operation 
Code 


4000 


5000 


6000 
7000 
8000 
9000 
A000 
BOOO 
C000 
DOOO 
E000 


FOOO 


Mnemonic 
Operation 
Code 


SZC 


SOCB 


Name 


Set Zeros Corresponding, 
Word 


Set Zeros Corresponding, 
Byte 


Subtract Word 
Subtract Byte 
Compare Words 
Compare Bytes 
Add Words 
Add Bytes 
Move Word 
Move Byte 


Set Ones Corresponding, 
Word 


Set Ones Corresponding, 
Byte 


Format 


I 


HH HH HH HF HF SS SS F&F 


Paragraph 


3.78 


3.79 


3.13 
3.14 
3.43 
3.44 
3.10 
3.11 
3.64 
3.65 
3.76 


3.77 
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ALPHABETICAL INSTRUCTION TABLE 


Mnemonic Hexadecimal 
Operation Operation 


Code Code Name Format Paragraph 
A A000 Add Words I 3.10 
AB BOOO Add Bytes I 3.11 
ABS 0740 Absolute Value VI 3.21 
AI 0220 Add Immediate VIII 3.12 
ANDI 0240 AND Immediate VIII 3.70 
B 0440 Branch VI 3.24 
BL 0680 Branch and Link VI 3.25 
BLWP 0400 Branch and Load Workspace VI 3.26 
Pointer 
c 8000 Compare Words I 3.43 
CB 9000 Compare Bytes I 3.44 
CI 0280 Compare Immediate VIII 3.45 
CKOF 03C0 Clock Off VII 3.51 
CKON 03A0 Clock On VII 3.52 
CLR 04C0 Clear Operand VI 3.74 
coc 2000 Compare Ones Corresponding III 3.46 
CZC 2400 Compare Zeros Corresponding III 3.47 
DEC 0600 Decrement By One VI 3.19 
DECT 0640 Decrement By Two VI 3.20 
DIV 3C00 Divide IX 3.16 
IDLE 0340 Computer Idle VII 3,50 
INC 0580 Increment By One VI 3.17 
INCT 05CO Increment By Two VI 3.18 
INV 0540 Invert VI 3.23 
JEQ 1300 Jump Equal II 3.35 
JGT 1500 Jump Greater Than II 3.33 
JH 1BO00 Jump High II 3.29 
JHE 1400 Jump High Or Equal LE 3.31 
JL 1A00 Jump Low IT 3.30 
JLE 1200 Jump Low Or Equal II 3,32 
JLT 1100 Jump Less Than II 3.34 
JMP 1000 Jump Unconditional II 3,28 
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ALPHABETICAL INSTRUCTION TABLE (Continued) 


Mnemonic Hexadecimal 
Operation Operation 


Code Code Name Format Paragraph 
JNC 1700 Jump No Carry II 3.38 
JNE 1600 Jump Not Equal II 3.36 
JNO 1900 Jump No Overflow II 3.39 
JOC 1800 Jump On Carry bia 3.37 
JOP 1C00 Jump Odd Parity II 3.40 
LDCR 3000 Load Communication Register IV 3.57 
LDD 07CO Long Distance Destination VI 3,88 
LDS 0780 Long Distance Source VI 3.87 
LI 0200 Load Immediate VIII 3.60 
LIMI 0300 Load Interrupt Mask VIII 3.61 
Immediate 
LMF 0320 Load Memory Map File X 3.63 
LREX O03E0 Load or Restart Execution VII 3.53 
LWPI 02E0 Load Workspace Pointer VIII 3.62 
Immediate 
MOV Co00 Move Word I 3.64 
MOVB DOOO Move Byte I 3.65 
MPY 3800 Multiply IX 3.15 
NEG 0500 Negate VI 3.22 
ORI 0260 OR Immediate VIII 3.7] 
RSET 0360 Computer Reset VII 3.49 
RTWP 0380 Return From Interrupt VII 3.27 
Subroutine 
Ss 6000 Subtract Word I 3.13 
SB 7000 Subtract Byte I 3.14 
SBO 1D00 Set Bit To One TI 3.54 
SBZ 1E00 Set Bit To Zero II 3.55 
SETO 0700 Set Ones VI 3.75 
SLA OAOO Shift Left Arithmetic V 3.82 
SOC E000 Set Ones Corresponding,Word I 3.76 
SOCB FOOO Set Ones Corresponding, I 3.77 


Byte 
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ALPHABETICAL INSTRUCTION TABLE (Continued) 


Mnemonic Hexadecimal 
Operation Operation 


Code Code Name Format Paragraph 
SRA 0800 Shift Right Arithmetic V 3.81 
SRC OBOO Shift Right Circular V 3.84 
SRL 0900 Shift Right Logical V 3.83 
STCR 3400 Store Communication IV 3.58 
Register 
STST 02C0 Store Status VIII 3.67 
STWP 02A0 Store Workspace Pointer VIII 3.68 
SWPB 06CO Swap Bytes VI 3.66 
SZC 4000 Set Zeros Corresponding, I 3.78 
Word 
SZCB 5000 Set Zeros Corresponding, I 3.79 
Byte 
TB 1F00 Test Bit II 3.56 
X 0480 Execute VI 3.41 
XOP 2C00 Extended Operation IX 3,85 
XOR 2800 Exclusive OR III 3.72 
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ASSEMBLER DIRECTIVE TABLE 


The assembler directives for the TA 1630 Assembly Language are listed in 
table F-1. All directives may include a comment field following the ope- 
rand field, Those directives that do not require an operand field may 
have a comment field following the operator field. Those directives that 
have optional operand fields (RORG and END) may have comment fields only 
when they have operand fields. 


The following symbols and conventions are used in defining the syntax of 
assembler directives: 


e Angle brackets (<>) enclose items supplied by the user 

e Brackets ([]) enclose optional items 

e An ellipsis (...) indicates that the preceding item may be repeated 
e Braces (Ft) enclose two or more items of which one must be chosen, 


The following words are used in defining the items used in assembler di- 
rectives: 


e symbol - 

e label - a symbol used in the label field 

e string - a character string of a length defined for each directive 
@ expr - an expression 

e wd expr - well-defined expression 

e term 


@ operation - mnemonic operation code, macro name, or previously defined 
operation or extended operation 
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Table F-1. Assembler Directives 


Force Word 


Directive Syntax Boundary Note 
Output Options OPTION <keyword> [,<keyword> ]... NA 5 
Page Title [<label> ] TITL <string> NA 

Program Iden- [<klabel> ] IDT <string> NA 

tifier 

Copy Source File [<label>] COPY <file name> NA 

External Defi- [<label> ] DEF <symbol>[,<symbol>],.. NA 

nition 

External Refe- [Klabel> ] REF <symbol>[,<symbol>],.. NA 

rence 

Secondary Refe- [Klabel>] SREF <symbol>[,<symbol>],.. NA 

rence 

Force Load ee LOAD <symbol> [,<symbol>],.. NA 

Absolute Origin <label> | AORG <wd expr> No 

Relocatable Origin [/Klabel>] RORG [xexpr> ] No 3 
Dummy Origin [<label> ] DORG <expr> No 

Workspace Pointer [<label> ] WPNT <label> NA 

Block Starting [<label> ] BSS <wd expr> No 

with Symbol 

Block Ending [<label> ] BES <wd expr> No 

with Symbol 

Initialize Word [<label> ] DATA <expr>[,<expr> ]... Yes 

Initialize Text [<label> ] TEXT [- ] <string> No Z 
Define Extended [Klabel>] DXOP <symbol>,<term> NA 

Operation 

Define Operation [Klabel>] DFOP <symbol>,<operation> NA 

Define Assembly- <label> EQU <expr> NA 3 
Time Constant 

Word Boundary [<label> ] EVEN Yes 

No Source List [<label> ] UNL NA 

List Source [<label> ] LIST NA 

Page Eject [<label> ] PAGE NA 

Initialize Byte | [<label>] BYTE <wd expr>[,<wd expr>],..No 

Program End [<label>] END [<symbol> ] NA 4 
Program Segment /[(<label> ] PSEG Yes 

Program Segment  [<label> ] PEND Yes 

End 

Data Segment [<label> ] DSEG Yes 

Data Segment End [<label> ] DEND Yes 

Common Segment [<label>] CSEG [KXstring> ] Yes 

Common Segment [<label> ] CEND Yes 

END [<label> ] END [Symbol ] NA 4 
Assemble if [<label> ] ASMIF <expr> NA 3 
Assemble else [<label> ] ASMELS NA 

Assemble end [<Label> ] ASMEND NA 

Set Macro Nesting [<label> ] SETRMNL <expr> NA 

Level 


Set Right Margin [<label>] SETRM <expr> NA 
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NOTES 
1. The expression must be relocatable. 


2. The minus sign causes the assembler to negate the rightmost 
character. 

Symbols in expressions must have been previously defined. 

4, Symbol must have been previously defined. 

Keywords are XREF, OBJ, SYMT, NOLIST, TUNLST, DUNLST, BUNLST, 
and MUNLST. 
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MACRO_LANGUAGE_ TABLE 


The syntax of the statements that contain the Macro Language verbs is 
shown in the following table. 


Statement 
Macro 


Variable 
Assign 


Name 
Go to 
Exit 
Call 
If 
Else 
End if 
End 


Syntax 
<macro name>b...SMACROb...[<parm>]...6...[<comment>] 
b...SVARb...<var>[,<var>]...6...[<comment>] 


<expression> | 
b...SASGb... <atrine g BIO <var>b,...[<comment>] 


<label>6...SNAMEb... [<comment>] 
b...SGOTOb...<Label>b...[<comment>] 
b...SEXITb... [<comment>] 

b...SCALLb...<macro name>b,..[<comment>] 
b...SIFb...<expression>b...[<comment>] 
b...SELSEb... [<comment>] 
...SENDIFb...[<comment>] 
<label>b...SEND6b...<macro name>b...[<comment>] 


MACRO Variable Components 


Qualifier 


S 
A 
V 
L. 


Symbol Components 


Qualifier 


SS 
SV 
SA 
SL 
SU 


SG 


Meaning 


The string component of the variable. 
The attribute component of the variable. 
The value component of the variable, 

The length component of the variable, 


Meaning 


String component of a symbol that is the string component 
of a variable, 

Value component of a symbol that is the string component 
of a variable, 

Attribute component of a symbol that is the string com- 
ponent of a variable, 

Length component of a symbol that is the string compo- 
nent of a variable, 

User attribute component of symbol that is the string 
component of a variable, 

Segment component of symbol that is the string component 
of a variable, 
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APPENDIX H 
CRU INTERFACE EXAMPLE 


General 


This appendix contains an example of programming for a CRU device to aid 
the user in programming any CRU device which the executive does not sup- 
port. A medium=-speed line printer having the characteristics listed in 
table H-1 is used as an example device, although this device is supported 
by the executives, 


Table H-1, Medium-Speed Line Printer Characteristics 


Function Description 

Print line length 80 characters maximum 

Paper width Variable, up to 9-1/2 inches, sprocket fed 
Character format 5x7 dot matrix, 10 characters per inch (horiz) 


6 lines per inch (vertical) 


Printer speed 60 lines per minute for 80 character lines or 
150 lines per minute for 20 character lines 


Printer input buffer 80 characters 


Buffer data rate 75,000 characters per second (8-bit characters 
supplied in parallel) maximum 


Software Interface Requirements 


The control characters recognized by the line printer, and the control 

and response signals for the printer are listed in table H-2. An arbitrary 
CRU signal arrangement shown in figure H-] has been selected for this ex- 
ample. 


Assembly Language Instructions 


The available assembly language instructions that may be used to cause 
data transfers between the CRU and the printer are: 


e SBO - Set Bit to Logic One 

e SBZ - Set Bit to Logic Zero 

e LDCR - Load Communications Register 
e TB - Test Bit 


The instructions are described and examples of their use are shown in 
Section III. 


H/2 
Table H-2,. Printer Control and Response Signals 


Signal Definition Hexadecimal Value 


Control Characters 


LF Line Feed 0A16 
CR Carriage Return OD) ¢ 
TOF Top of Form 0C1 6 
PS Printer Strobe N16 
PP Printer Prime FFi¢ 
PD Printer De-select 1316 
Discrete Signals 

PL Paper Low <«<— 

PSD Printer Selected <— 

PF Printer Fault <— 

BSY Printer Busy «—— 

IM Interrupt Mask ——> 

IR Interrupt Reset —— 

ACK Acknowledge <—— 


* <— Signal from printer 
— Signal to printer 


H.2.2 Software Routines Required 


To properly operate the medium-speed line printer, software routines must 
provide initialization, character transfer, and end-of-data reporting. 
The following paragraphs define these operations and provide specific 
programming examples. 


H.2.2.1 Initialization 


Initialization should occur when power is applied to the system. A gene- 
ralized approach to initialization with specific printer initialization 
follows: 


AORG 0 
DATA PWRONW INITIALIZE POWER ON 


DATA PWRONP INTERRUPT VECTOR 


OTHER VECTORS 
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CRU OUTPUTS 


(A)128706 


Figure H-1. CRU Bit Assignments 


RORG 

PWRONP EQU $ 

PRBASE EQU >120 

PRIME EQU 9 

STROBE EQU 8 

MASK EQU 14 

INT EQU 15 

BUSY EQU 0 

* 

* PRINTER INITIALIZATION 

* 
Lu 12,PRBASE 
SBZ PRIME 
SBZ STROBE 


SBZ MASK 


PRINTER OUTPUTS (CRU INPUTS) 


DATA BIT 0 (LSB) BUSY 
DATA BIT 1 FAULT 
DATA BIT 2 SELECTED 
DATA BIT 3 NOT USED 
DATA BIT 4 NOT USED 
DATA BIT 5 NOT USED 
DATA BIT 6 NOT USED 
DATA BIT 7 (MSB) NOT USED 
STROBE NOT USED 
PRIME NOT USED 
NOT USED NOT USED 
NOT USED NOT USED 
NOT USED NOT USED 
NOT USED NOT USED 
INTERRUPT MASK NOT USED 
INTERRUPT RESET ACKNOWLEDGE — 


REMAINDER OF PROGRA\. RELOCATABLE 
POWER ON INITIALIZATIO J 


OTHER INITIALIZATIONS 


CONNECTED TO MODULE SELECT 9 
RESET PRINTER 

TAKE DATA 

INTERRUPT MASK 

INTERRUPT RESET 

PRINTER BUSY 


LOAD CRU BASE ADDRESS 
SET PRIME TO ZERO 

SET STROBE TO ZERO 
MASK INTERRUPTS 


H/4 


H.2.2.2 Character Transfer 


Character transfer can be accomplished as follows by the use of a sub- 
routine call, The assumptions for the subroutine are: 


e Workspace register 8 (WR8) contains the address of the data to be 
printed, 


e Workspace register 9 (WR9) is used for temporary storage. 


e Workspace register 10 (WR10) contains the number of characters to 
transfer. 


e Workspace register 12 (WR12) contains the CRU base address. 


The following subroutine is one method of transferring characters to the 


printer: 

PRINTR EQU $ PRINT SUBROUTINE 

* 

* SET UP INTERRUPTS 

* 
SBZ INT RESET INTERRUPT 
LIMI 15 ENABLE LEVEL 15 
SBO MASK ENABLE INTERRUPTS 


* 


* TEST FOR PRINTER BUSY, PRINT IF NOT 

* BUSY, WAIT FOR ANY INTERRUPT IF BUSY 
* AND RETRY TEST 

* 


TSTBSY TB BUSY TEST BUSY BIT 
JEQ PRINT IF NOT BUSY 
IDLE WAIT IF BUSY 
JMP TSTBSY RETRY TEST 
* CHARACTER PRINT SUBROUTINE 
* 
PRINT EQU $ START 
MOVB = *8+,9 WR9 CONTAINS PRINT CHAR 
INV 9 INVERT BITS (FALSE DATA) 
LDCR 9,8 OUTPUT TO PRINTER 
SBO STROBE — PULSE STROBE LINE 
SBZ STROBE = ABOUT 1.5 MICROSECONDS 
DEC 10 DECREMENT CHARACTER COUNT 
JEQ EXIT EXIT IF COMPLETE 
JMP TSTBSY | GO FOR NEXT CHARACTER 


* 


* EXIT CODE 
* 


EXIT SBZ MASK MASK INTERRUPT 
RTWP RETURN TO CALLER 


H.2.2.3 End-of-Data Reporting 
End-of-data reporting in the example subroutine is the exit code, which 
is executed when the character count in WR1O reaches zero. The code masks 
the interrupt and returns control to the calling routine. 
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H.2.2.4 Interrupt Routine 
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H.2.3 


In the character transfer subroutine, the CPU enters an idle state when 
the printer is busy. The occurrence of any enabled interrupt signal 
causes the CPU to resume processing. The printer is assumed to be con- 
nected at interrupt level 15, and all levels are enabled following exe- 
cution of the LIMI 15 instruction. The following interrupt routine re- 
sets the printer interrupt and returns control to the instruction follow- 
ing the interrupted instruction, the JMP TSTBSY instruction, in this 
case: 


AORG >3C INTERRUPT LEVEL 15 VECTOR 

DATA PRIWP WORKSPACE ADDRESS 

DATA PRIPC PROGRAM ADDRESS 
PRIWP RORG $-24 SET WORKSPACE ADDRESS RELATIVE TO 

DATA PRBASE CRU BASE ADDRESS 

RORG $+6 RESERVE REMAINDER OF WORKSPACE 
PRIPC EQU $ INTERRUPT ROUTINE 

SBZ INT RESET INTERRUPT 

RTWP 


Programming Notes 


A specific device to be programmed might require more sophisticated rou- 
tines. These are intended to show possible ways of programming input and 
output for a CRU device. Error tests may be included to transfer control 
to error recovery routines when errors are detected. Error recovery rou- 
tines may simply indicate the occurrence of an error or may correct or 
overcome the error. 
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TILINE INTERFACE EXAMPLE 


Introduction 


This appendix contains an example of programming for a TILINE device to 
aid the user in programming any TILINE device which the executive does 
not support. Figure I-1 shows a typical TILINE device, a disc controller, 
which is used for this example. Actual input/output for the disc is pro- 
vided by the executive. This example is only intended to illustrate the 


Figure I-1. 


CONTROL REGISTERS 


° 7 8 1S 
DISC STATUS 
COMMAND FORMAT 


CYLINDER ADDRESS 


BUSY/ACTIVATE 


TYPICAL 
TILINE ADDRESS 


principles involved in TILINE input/output programming. 


FFCOO 
FFCO! 
FFCO2 
FFCO3 
FFCO4 
FFCOS 
FFCO6 


FFCO7 


TILINE Device Controller Example 


INTERRUPT 


CORRESPONDING ADDRESS 
USED BY PROGRAM 


F800 
F802 
F804 
F806 
F808 
FBOA 
FsOC 


FSOE 
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I.2 Peripheral Controller Application 


Controllers for peripheral devices connected to the TILINE have a master 
interface for transferring data to and from memory. They also have a 

slave interface for receiving command information from the AU and for 
sending status information to the AU, A simplified block diagram for a 
disc controller is shown in figure I-1. Typical use of control registers 
accessed by the slave interface is also shown in figure I-1. It is assumed 
that address F800;¢ is assigned to the controller. This corresponds to 
TILINE address FFCO0)6. A program would operate the disc controller by 
moving the appropriate parameters into the control registers and setting 
the activate bit as follows: 


PARAMS DATA >017F COMMAND,FORMAT 
DATA >0000 SECTOR, SURFACE 
DATA 0 CYLINDER ADDRESS 
DATA >1000 WORD COUNT 
DATA BUFF MEMORY ADDRESS 
DATA >0201 EXT. MA, SELECTION 


* 


* TEST FOR DISC CONTROLLER BUSY 
* 


LI 7,>7FFF WR7 = BUSY TEST MASK 
COC @>F80E,7 TEST FOR BUSY 
JNE BUSY IF NOT 


x 

* TRANSFER DISC PARAMETER LIST FROM MEMORY TO 
* DISC CONTROLLER 

* 


LI 8,PARAMS WR8 = PARAMETER LIST ADDRESS 

LI 9,>F802 WR9 = DISC CONTROLLER ADDRESS 
FILL MOV *8+ *9+ MOVE LIST WORD TO CONTROLLER 

CI 9,>F80E STOP WHEN WR9 = CONT. STATUS ADDR. 

JNE FILL 

INV 7 WR7 = >8000 

SOC age SET ACTIVATE BIT 


The disc controller performs the action requested in the command register. 
During the time the controller is active, the busy flag is on. When the 
operation is complete the busy flag is turned off and an interrupt signal 
is generated. The interrupt can be connected to an external interrupt in- 
put line, as determined by the system designer. 
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EXAMPLE PROGRAM 


Creating A Source Program 


Once the source statements have been written, they must be prepared for 
input to the assembler using a medium that the computer is able to read. 

The statements can be entered into a disc file via the Text Editor supported 
by the TAXO Operating System. Refer to the appropriate TAXO User Manual 

for the Text Editor. 


Assembling A Source Program 


Once the source program is in machine-readable form, assembly of the code 
is the next step. The procedure for assembling a program is described in 
another section of this manual. The generalized procedure is as follows: 


1. When the operating system is not in execution, load, initialize, and 
start execution of the operating system. 


2. Place the source program in the appropriate device and place the de- 
vice in ready. Assign the devices and files required using SCI commands. 


3. Place the device on which the listing is to be printed in ready. 


4. Execute the assembler. The assembler should read the source program, 
print the listing, and write the object code on the output medium. 


The multi-pass assembler (SDSMAC) executes under TAXO. It requires a 
source input device, a printing device, a scratch file on disc, and an 
object file on disc. Refer to the TAXO Operator Manuals I and II for 
information about loading and executing TAXO, assigning the devices, 
and loading and executing SDSMAC. 


Example Program 


The source program shown in figure J-1 is an example of a source program 
written on coding forms from which the source programs are prepared. Fi- 
gure J-2 shows the listing produced by the assembler. The message printed 
as the program is executed is shown in figure J-3. The program executes 

on a TA 1630 with a terminal used by the TA customer service and it assumes 
that the CRU base address for this terminal is 000... 


COMMENTS 


OPERAND 
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Example Program (Sheet 1 of 4) 


Figure J-1. 
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2 ae ss ee DN i ee ee 
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(BE FR et (ie a Dc US A ie (en a Ms Fe DE cr 


COMMENTS 


OPERAND 


PROGRAMMED B 


(A)128625 (2/4) 


Example Program (Sheet 2 of 4) 


Figure J-1. 
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Example Program (Sheet 3 of 4) 


Figure J-1. 
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Example Program (Sheet 4 of 4) 


Figure J-1. 
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Table K-1. 
0 i 
1 02 
3 03 
3 04 
4 05 
5 06 
6 07 
7 08 
8 09 
9 OA 
A OB 
B oc 
Cc oD 
D OE 
E OF 
F 10 

2 
04 06 
06 09 
08 OC 
OA OF 
oc 12 
OE 15 
10 18 
12 1B 
14 1E 
16 21 
18 24 
1A 27 
iC 2A 
1E 2D 


NUMERICAL TABLES 
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Hexadecimal Arithmetic 


ADDITION TABLE 


38 


46 
4B 


4 5 6 7 8 
05 06 07 08 09 
06 07 08 09 #4=OA 
07 «#08 09 OA OB 
08 09 OA OB Oc 
09 OA OB oc OD 
OA OB OC OD OE 
OB OC OD OE OF 
oc OD OE OF 10 
OD OE OF 10 11 
OE OF 10 11 12 
OF 10 ii 12 13 
oO WwW 13. 14 
11 12 13 14 «15 
12 13 14 15 16 
13. 14° «+15 16 17 

MULTIPLICATION TABLE 

6 ? 8 9 A 
0c OE 10 12 14 
12 15 18 1B 1E 
18 1¢ 20 24 28 
1E 23 28 2D 32 
24 2A 30 36 3C 
2A St 38 .\3F 46 
30 38 40 48 50 
36 3F 48 51 5A 
3C 46 50 5A 64 
42 4D 58 63 6E 
48 54 60 6C 78 
4E 5B 68 75 82 
54 62 70 7E 8C 
5A 69 78 87 96 


El 


Table K-2, 


17 
281 
4 503 
72 057 
152 921 
Table K-3. 
2 
17 
E8 
918 
SAF3 
3 8D7E 
23 «=B6F2 
163 4578 
DEO B6B3 
8AC7 2304 
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Table of Powers of 169 


wo won num && WN KY OO 8 


a ee ed 
un fk &W NY KF CO 


0.10000 
0.62500 
0.39062 
0.24414 
0.15258 
0.95367 
0.59604 
0.37252 
0.23283 
0.14551 
0.90949 
0.56843 
0.35527 
0.22204 
0.13877 
0.86736 


Table of Powers of 1016 


10” 


0000 


womnanwnttk WN e OO 3 


| 
women nauk WNe CO 


00000 
00000 
50000 
06250 
78906 
43164 
64477 
90298 
06436 
91522 
47017 
41886 
13678 
46049 
78780 
17379 


1.0000 
0.1999 
0.28F5 
0.4189 


0.68DB 
0.A7C5 


0.10C6 


0.1AD7 
0.2AF3 


0.44B8 


0.6DF3 
0.AFEB 


0.1197 
0.1C25 


0.2D09 


0.480E 


0.734A 


0.B877 
0.1272 


0.1D83 


16> 
00000 
00000 
00000 
00000 
25000 
06250 
53906 
46191 
53869 
83668 
72928 
08080 
80050 
25031 
78144 
88403 


00000 x 
00000 x 
00000 x 
00000 x 
00000 x 
00000 x 
25000 x 
40625 x 
62891 x 
51807 x 
23792 x 
14870 x 
09294 x 
30808 x 
56755 x 
54721 x 


io 


0000 0000 
9999 9999 
C28F 5C28 
374B C6A7 


8BAC 710C 
AC47 1B47 


F7A0 BSED 


F29A BCAF 
1DC4 6118 


2FAO 9B5A 


7F67 5SEF6 
FFOB CB24 


9981 2DEA 
C268 4976 
370D 4257 
BE7B 9D58 


CASF 6226 


AA32 36A4 
5DD1 D243 
C94F B6D2 


0000 
999A 
F5C3 
EF9E 
B296 
8423 
8D37 
4858 
73BF 
52CC 
EADF 
AAFF 
1119 
81C2 
3604 
566D 
FOAE 
B449 
ABAI1 
AC35 


Ce 
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Table K-4, Table of Powers of Two 


K/4 
Table K-5. Hexadecimal-Decimal Integer 
Conversion Table 


The table appearing on the following pages provides a means for direct 
conversion of decimal integers in the range of 0 to 4095 and for hexa- 
decimal integers in the range of 0 to FFF. 


To convert numbers above those ranges, add table values to the figures 


below: 

Hexadecimal Decimal Hexadecimal Decimal 
01 000 4096 20 000 131 072 
02 000 8192 30 000 196 608 
03 000 12 288 40 000 262 144 
04 000 16 384 50 000 327 680 
05 000 20 480 60 000 393 216 
06 000 24 576 70 000 458 752 
07 000 28 672 80 000 524 288 
08 000 32 768 90 000 589 824 
09 000 36 864 AO 000 655 360 
0A 000 40 960 BO 000 720 896 
OB 000 45 056 CO 000 786 432 
Oc 000 49 152 DO 000 851 968 
OD 000 53 248 E0 000 917 504 
OE 000 57 344 FO 000 983 040 
OF 000 61 440 100 000 1 048 576 
10 000 65 536 200 000 2 097 152 
11 000 69 632 300 000 3145 728 
12 000 73728 400 000 4194 304 
13 000 77 824 500 000 5 242 880 
14 000 81 920 600 000 6 291 456 
15 000 86 016 700 000 7 340 032 
16 000 90112 800 000 8 388 608 
17 000 94 208 900 000 9 437 184 
18 000 98 304 A00 000 10 485 760 
19 000 102 400 BOO 000 11 534 336 
1A 000 106 496 C00 000 12 582 912 
1B 000 110 592 DOO 000 13 631 488 
1C 000 114 688 E00 000 14 680 064 
1D 000 118 784 FO00 000 15 728 640 
1E 000 122 880 1 000 000 16 777 216 


1F 000 126 976 2 000 000 33 554 432 
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Table K-5, Hexadecimal-Decimal Integer Conversion Table (Continued) 


000 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 0010 0011 0012 0013 0014 0015 
010 0016 0017 0018 0019 0020 0021 0022 0023 0024 0025 0026 0027 0028 0029 0030 0031 
020 0032 0033 0034 0035 0036 0037 0038 0039 0040 0041 0042 0043 0044 0045 0046 0047 
030 0048 0049 0050 0051 0052 0053 0054 0055 0056 0057 0058 0059 0060 0061 0062 0063 


040 0064 0065 0066 0067 0068 0069 0070 0071 0072 0073 0074 0075 0076 0077 0078 0079 
050 0080 0081 0082 0083 0084 0085 0086 0087 0088 0089 0090 0091 0092 0093 0094 0095 
060 0096 0097 0098 0099 0100 0101 0102 0103 0104 0105 0106 0107 0108 0109 0110 0111 
070 0112 0113 0114 0115 0116 0117 0118 0119 0120 0121 0122 0123 0124 0125 0126 0127 


080 0128 0129 0130 0131 0132 0133 0134 0135 0136 0137 0138 0139 0140 0141 0142 0143 
090 0144 0145 0146 0147 0148 0149 0150 0151 0152 0153 0154 0155 0156 0157 0158 0159 
0AO 0160 0161 0162 0163 0164 0165 0166 0167 0168 0169 0170 0171 0172 0173 0174 0175 
OBO 0176 0177 0178 0179 0180 0181 0182 0183 0184 0185 0186 0187 0188 0189 0190 0191 


0co 0192 0193 0194 0195 0196 0197 0198 0199 0200 0201 0202 0203 0204 0205 0206 0207 
ODO 0208 0209 0210 0211 0212 0213 0214 0215 0216 0217 0218 0219 0220 0221 0222 0223 
0EO 0224 0225 0226 0227 0228 0229 0230 0231 0232 0233 0234 0235 0236 0237 0238 0239 
OFO 0240 0241 0242 0243 0244 0245 0246 0247 0248 0249 0250 0251 0252 0253 0254 0255 


100 0256 0257 0258 0259 0260 0261 0262 0263 0264 0265 0266 0267 0268 0269 0270 0271 
110 0272 0273 0274 0275 0276 0277 0278 0279 0280 0281 0282 0283 0284 0285 0286 0287 
120 0288 0289 0290 0291 0292 0293 0294 0295 0296 0297 0298 0299 0300 0301 0302 0303 
130 0304 0305 0306 0307 0308 0309 0310 0311 0312 0313 0314 0315 0316 0317 0318 0319 


140 0320 0321 0322 0323 0324 0325 0326 0327 0328 0329 0330 0331 0332 0333 0334 0335 
150 0336 0337 0338 0339 0340 0341 0342 0343 0344 0345 0346 0347 0348 0349 0350 0351 
160 0352 0353 0354 0355 0356 0357 0358 0359 0360 0361 0362 0363 0364 0365 0366 0367 
170 0368 0369 0370 0371 0372 0373 0374 0375 0376 0377 0378 0379 0380 0381 0382 0383 


180 0384 0385 0386 0387 0388 0389 0390 0391 0392 0393 0394 0395 0396 0397 0398 0399 
190 0400 0401 0402 0403 0404 0405 0406 0407 0408 0409 0410 0411 0412 0413 0414 0415 
1A0 0416 0417 0418 0419 0420 0421 0422 0423 0424 0425 0426 0427 0428 0429 0430 0431 
1B0 0432 0433 0434. 0435 0436 0437 0438 0439 0440 0441 0442 0443 0444 0445 0446 0447 


1CO 0448 0449 0450 0451 0452 0453 0454 0455 0456 0457 0458 0459 0460 0461 0462 0463 
1D0 0464 0465 0466 0467 0468 0469 0470 0471 0472 0473 0474 0475 0476 0477 0478 0479 
1E0 0480 0481 0482 0483 0484 0485 0486 0487 0488 0489 0490 0491 0492 0493 0494 0495 
1F0 0496 0497 0498 0499 0500 0501 0502 0503 0504 0505 0506 0507 0508 0509 0510 0511 


200 0512 0513 0514 0515 0516 0517 0518 0519 0529 0521 0522 0523 0524 0525 0526 0527 
210 0528 0529 0530 0531 0532 0533 0534 0535 0536 0537 0538 0539 0540 0541 0542 0543 
220 0544 0545 0546 0547 0548 0549 0550 0551 0552 0553 0554 0555 0556 0557 0558 0559 
230 0560 0561 0562 0563 0564 0565 0566 0567 0568 0569 0570 0571 0572 0573 0574 0575 
240 0576 0577 0578 0579 0580 0581 0582 0583 0584 0585 0586 0587 0588 0589 0590 0591 
250 0592 0593 0594 0595 0596 0597 0598 0599 0600 0601 0602 0603 0604 0605 0606 0607 
260 0608 0609 0610 0611 0612 0613 0614 0615 0616 0617 0618 0619 0620 0621 0622 0623 
270 0624 0625 0626 0627 0628 0629 0630 0631 0632 0633 0634 0635 0636 0637 0638 0639 
280 0640 0641 0642 0643 0644 0645 0646 0647 0648 0649 0650 0651 0652 0653 0654 0655 
290 0656 0657 0658 0659 0660 0661 0662 0663 0664 0665 0666 0667 0668 0669 0670 0671 


2A0 0672 0673 0674 0675 0676 0677 0678 0679 0680 0681 0682 0683 0684 0685 0686 0687 
2B0 0688 0689 0690 0691 0692 0693 0694 0695 0696 0697 0698 0699 0700 0701 0702 0703 


2C0 0704 0705 0706 0707 0708 0709 0710 0711 0712 0713 0714 0715 0716 0717 0718 0719 
2D0 0720 0721 0722 0723 0724 0725 0726 0727 0728 0729 0730 0731 0732 0733 0734 0735 
2E0 0736 0737 0738 0739 0740 0741 0742 0743 0744 0745 0746 0747 0748 0749 0750 0751 
2F0 0752 0753 0754 0755 0756 0757 0758 0759 0760 0761 0762 0763 0764 0765 0766 0767 


® 
= 
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Table K-5, 
0 
300 0768 
310 0784 
320 0800 
330 0816 
340 0832 
350 0848 
360 0864 
370 0880 
380 0896 
390 0912 
3A0 0928 
3B0 0944 
3Cc0 0960 
3D0 0976 
3E0 0992 
3F0 1008 
400 1024 
410 1040 
420 1056 
430 1072 
440 1088 
450 1104 
460 1120 
470 1136 
480 1152 
490 1168 
4A0 1184 
4B0 1200 
4CO 1216 
4D0 1232 
4E0 1248 
4F0 1264 
500 1280 
510 1296 
520 1312 
530 1328 
540 1344 
550 1360 
560 1376 
570 1392 
580 1408 
590 1324 
5A0 1440 
3B0 1456 
5CO 1472 
5D0 1488 
5E0 1504 


5F0O 
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Table (Continued) 
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Table K-5. 
0 
600 1536 
610 1552 
620 1568 
630 1584 
640 1600 
650 1616 
660 1632 
670 1648 
680 1664 
690 1680 
6A0 1696 
6B0 1712 
6CO 1728 
6D0 1744 
6E0 1760 
6FO 1776 
700 1792 
710 1808 
720 1824 
730 1840 
740 1856 
750 1872 
760 1888 
770 1904 
780 1920 
790 1936 
7A0 1952 
7B0 1968 
7CO 1984 
7D0 2000 
7E0O 2016 
7F0 2032 
800 2048 
810 2064 
820 2080 
830 2096 
840 2112 
850 2128 
860 2144 
870 2160 
880 2176 
890 2192 
8A0 2208 
8BO 2224 
8CO 2240 
8D0 2256 
8E0O 2272 
8FO 2288 
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Hexadecimal-Decimal Integer Conversion Table (Continued) 


Table K-5. 
0 
900 2304 
910 2320 
920 2336 
930 2352 
940 2368 
950 2384 
960 2400 
970 2416 
980 2432 
990 2448 
9A0 2464 
9B0 2480 
9CO 2496 
9D0 2512 
9EO 2528 
9FO 2544 
A00 2560 
Al0 2576 
A20 2592 
A30 2608 
A40 2624 
A50 2640 
A60 2656 
A70 2672 
A80 2688 
A90 2704 
AAO 2720 
ABO 2736 
ACO 2752 
ADO 2768 
AEO 2784 
AFO 2800 
BOO 2816 
B10 2832 
B20 2848 
B30 2864 
B40 2880 
B50 2896 
B60 2912 
B70 2928 
B80 2944 
B90 2960 
BAO 2976 
BBO 2992 
BCO 3008 
BDO 3024 
BEO 3040 
BFO 3056 


K/8 
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Table (Continued) 
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Table K-5. 


0 1 2 3 


3072 3073 3074 3075 
3088 3089 3090 3091 
3104 3105 3106 3107 
3120 3121 3122 3123 


3136 3137 3138 3139 
3152 3153 3154 3155 
3168 3169 3170 3171 
3184 3185 3186 3187 


3200 3201 3202 3203 
3216 3217 3218 3219 
3232 3233 3234 3235 
3248 3249 3250 3251 


3264 3265 3266 3267 
3280 3281 3282 3283 
3296 3297 3298 3299 
3312 3313 3314 3315 


3328 3329 3330 3331 
3344 3345 3346 3347 
3360 3361 3362 3363 
3376 3377 3378 3379 


3392 3393 3394 3395 
3408 3409 3410 3411 
3424 3425 3426 3427 
3440 3441 3442 3443 


3456 3457 3458 3459 
3472 3473 3474 3475 
3488 3489 3490 3491 
3504 3505 3506 3507 


3520 3521 3522 3523 
3536 3537 3538 3539 
3552 3553 3854 3555 
3568 3569 3570 3571 


3584 3585 3586 3587 
3600 3601 3602 3603 
3616 3617 3618 3619 
3632 3633 3634 3635 


3648 3649 3650 3651 
3664 3665 3666 3667 
3680 3681 3682 3683 
3696 3697 3698 3699 


3712 3713 3714 3715 
3728 3729 3730 3731 
3744 3745 3746 3747 
3760 3761 3762 3763 
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4 5 6 7 


3076 3077 3078 3079 
3092 3093 3094 3095 
3108 3109 3110 3111 
3124 3125 3126 3127 


3140 3141 3142 3143 
3156 3157 3158 3159 
3172 3173 3174 3175 
3188 3189 3190 3191 


3204 3205 3206 3207 
3220 3221 3222 3223 
3236 3237 3238 3239 
3252 3253 3254 3255 


3268 3269 3270 3271 
3284 3285 3286 3287 
3300 3301 3302 3303 
3316 3317 3318 3319 


3332 3333 3334 3335 
3348 3349 3350 3351 
3364 3365 3366 3367 
3380 3381 3382 3383 


3396 3397 3398 3399 
3412 3413 3414 3415 
3428 3429 3430 3431 
3444 3445 3446 3447 


3460 3461 3462 3463 
3476 3477 3478 3479 
3492 3493 3494 3495 
3508 3509 3510 3511 


3524 3525 3526 3527 
3540 3541 3542 3543 
3556 3557 3558 3559 
3572 3573 3574 3575 


3588 3589 3590 3591 
3604 3605 3606 3607 
3620 3621 3622 3623 
3636 3637 3638 3639 


3652 3653 3654 3655 
3668 3669 3670 3671 
3684 3685 3686 3687 
3700 3701 3702 3703 


3716 3717 3718 3719 
3732 3733 3734 3735 
3748 3749 3750 3751 
3764 3765 3766 3767 


8 9 A B 


3080 3081 3082 3083 
3096 3097 3098 3099 
3112 3113 3114 3115 
3128 3129 3130 3131 


3144 3145 3146 3147 
3160 3161 3162 3163 
3176 3177 3178 3179 
3192 3193 3194 3195 


3208 3209 3210 3211 
3224 3225 3226 3227 
3240 3241 3242 3243 
3256 3257 3258 3259 


3272 3273 3274 3275 
3288 3289 3290 3291 
3304 3305 3306 3307 
3320 3321 3322 3323 


3336 3337 3338 3339 
3352 3353 3354 3355 
3368 3369 3370 3371 
3384 3385 3386 3387 


3400 3401 3402 3403 
3416 3417 3418 3419 
3432 3433 3434 3435 
3448 3449 3450 3451 


3464 3465 3466 3467 
3480 3481 3482 3483 
3496 3497 3498 3499 
3512 3513 3514 3515 


3528 3529 3530 3531 
3544 3545 3546 3547 
3560 3561 3562 3563 
3576 3577 3578 3579 


3592 3593 3594 3595 
3608 3609 3610 3611 
3624 3625 3626 3627 
3640 3641 3642 3643 


3656 3657 3658 3659 
3672 3673 3674 3675 
3688 3689 3690 3691 
3704 3705 3706 3707 


3720 3721 3722 3723 
3736 3737 3738 3739 
3752 3753 3754 3755 
3768 3769 3770 3771 


Hexadecimal-Decimal Integer Conversion Table (Continued) 


cS DBD Ef F 


3084 3085 3086 3087 
3100 3101 3102 3103 
3116 3117 3118 3119 
3132 3133 3134 3135 


3148 3149 3150 3151 
3164 3165 3166 3167 
3180 3181 3182 3183 
3196 3197 3198 3199 


3212 3213 3214 3215 
3228 3229 3230 3231 
3244 3245 3246 3247 
3260 3261 3262 3263 


3276 3277 3278 3279 
3292 3293 3294 3295 
3308 3309 3310 3311 
3324 3325 3326 3327 


3340 3341 3342 3343 
3356 3357 3358 3359 
3372 3373 3374 3375 
3388 3389 3390 3391 


3404 3405 3406 3407 
3420 3421 3422 3423 
3436 3437 3438 3439 
3452 3453 3454 3455 


3468 3469 3470 3471 
3484 3485 3486 3487 
3500 3501 3502 3503 
3516 3517 3518 3519 


3532 3533 3534 3535 
3548 3549 3550 3551 
3564 3565 3566 3567 
3580 3581 3582 3583 


3596 3597 3598 3599 
3612 3613 3614 3615 
3628 3629 3630 3631 
3644 3645 3646 3647 


3660 3661 3662 3663 
3676 3677 3678 3679 
3692 3693 3694 3695 
3708 3709 3710 3711 


3724 3725 3726 3727 
3740 3741 3742 3743 
3756 3757 3758 3759 
3772 3773 3774 3775 


Table K-5. 


0 1 2 3 


3776 3777 3778 3779 
3792 3793 3794 3795 
3808 3809 3810 3811 
3824 3825 3826 3827 


3840 3841 3842 3843 
3856 3857 3858 3859 
3872 3873 3874 3875 
3888 3889 3890 3891 


3904 3905 3906 3907 
3920 3921 3922 3923 
3936 3937 3938 3939 
3952 3953 3954 3955 


3968 3969 3970 3971 
3984 3985 3986 3987 
4000 4001 4002 4003 
4016 4017 4018 4019 


4032 4033 4034 4035 
4048 4049 4050 4051 
4064 4065 4066 4067 
4080 4081 4082 4083 
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4 5 6 7 


3780 3781 3782 3783 
3796 3797 3798 3799 
3812 3813 3814 3815 
3828 3829 3830 3831 


3844 3845 3846 3847 
3860 3861 3862 3863 
3876 3877 3878 3879 
3892 3893 3894 3895 


3908 3909 3910 3911 
3924 3925 3926 3927 
3940 3941 3942 3943 
3956 3957 3958 3959 


3972 3973 3974 3975 
3988 3989 3990 3991 
4004 4005 4006 4007 
4020 4021 4022 4023 


4036 4037 4038 4039 
4052 4053 4054 4055 
4068 4069 4070 4071 
4084 4085 4086 4087 


8 9 A B 


3784 3785 3786 3787 
3800 3801 3802 3803 
3816 3817 3818 3819 
3832 3833 3834 3835 


3848 3849 3850 3851 
3864 3865 3866 3867 
3880 3881 3882 3883 
3896 3897 3898 3899 


3912 3913 3914 3915 
3928 3929 3930 3931 
3944 3945 3946 3947 
3960 3961 3962 3963 


3976 3977 3978 3979 
3992 3993 3994 3995 
4008 4009 4010 4011 
4024 4025 4026 4027 


4040 4041 4042 4043 
4056 4057 4058 4059 
4072 4073 4074 4075 
4088 4089 4090 4091 


Hexadecimal-Decimal Integer Conversion Table (Continued) 


Cc D €E F 


3788 3789 3790 3791 
3804 3805 3806 3807 
3820 3821 3822 3823 
3836 3837 3838 3839 


3852 3853 3854 3855 
3868 3869 3870 3871 
3884 3885 3886 3887 
3900 3901 3902 3903 


3916 3917 3918 3919 
3932 3933 3934 3935 
3948 3949 3950 3951 
3964 3965 3966 3967 


3980 3981 3982 3983 
3996 3997 3998 3999 
4012 4013 4014 4015 
4028 4029 4030 4031 


4044 4045 4046 4047 
4060 4061 4062 4063 
4076 4077 4078 4079 
4092 4093 4094 4095 


1630/Ass/0281/e 
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Table K-6. Hexadecimal-Decimal Fraction Conversion Table 


Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal 

00 000000 .00000 00000 40 000000 .25000 00000 80 000000 .50000 00000 .C0 000000 .75000 00000 
01 000000 .00390 62500 41 000000 .25390 62500 81 000000 .50390 62500 .C1 000000 .75390 62500 
02 000000 .00781 25000 42 000000 .25781 25000 82 000000 .50781 25000 .C2 000000 .75781 25000 
03 000000 .01171 87500 .43 000000 .26171 87500 .83 000000 .51171 87500 .C3 00 0000 .76171 87500 
04 000000 .01562 50000 44 000000 .26562 50000 84 000000 .51562 50000 .C4 000000 .76562 50000 
0S 000000 .01953 12500 45 000000 .26953 12500 .85 000000 51953 12500 .C5 000000 .76953 12500 
06 000000 .02343 75000 46 000000 .27343 75000 .86 000000 .52343 75000 .C6 0000 00 .77343 75000 
07 000000 .02734 37500 47 000000 .27734 37500 87 000000 .52734 37500 .C7 000000 .77734 37500 
08 000000 .03125 00000 48 000000 .28125 00000 88 000000 .53125 00000 .C8 00 0000 .78125 00000 
09 000000 .03515 62500 49 000000 .28515 62500 .89 000000 53515 62500 .C9 000000 .78515 62500 
0A 000000 .03906 25000 4A 000000 .28906 25000 8A 000000 .53906 25000 .CA00 0000 .78906 25000 
0B 000000 .04296 87500 4B 000000 .29296 87500 8B 000000 .54296 87500 .CB 000000 .79296 87500 
0C 000000 4687 50000 4C 000000 .29687 50000 8C 000000 54687 50000 .CC 000000 .79687 50000 
0D 000000 .05078 12500 4D 000000 .30078 12500 8D 000000 .55078 12500 .CD00 0000 .80078 12500 
OE 000000 .05468 75000 4E 000000 .30468 75000 8E 000000 .55468 75000 .CE 00 00 00 .80468 75000 
OF 000000 .05859 37500 .4F 000000 .30859 37500 8F 000000 .55859 37500 .CF 000000 80859 37500 
10 000000 .06250 00000 50 000000 .31250 00000 .90 000000 .56250 00000 .D000 00 00 81250 00000 
-11 000000 .06640 62500 51 000000 .31640 62500 91 000000 .56640 62500 .D1 000000 .81640 62500 
12 000000 .07031 25000 52 000000 .32031 25000 .92 000000 .57031 25000 .D200 0000 .82031 25000 
13° 000000 .07421 87500 53 000000 .32421 87500 93 000000 .57421 87500 .D300 0000 .82421 87500 
-14 0000 00 .07812 50000 54 000000 .32812 50000 94 000000 .57812 50000 .D400 0000 .82812 50000 
-1S 000000 .08203 12500 .55 000000 .33203 12500 .95 000000 .58203 12500 .DS00 0000 .83203 12500 
-16 000000 .08593 75000 .56 000000 .33593 75000 .96 000000 .58593 75000 .D600 0000 .83593 75000 
-17 000000 .08984 37500 57 000000 .33984 37500 .97 000000 .58984 37500 .D700 0000 .83984 37500 
18 000000 .09375 00000 58 000000 .34375 00000 98 000000 .59375 00000 .D800 00 00 84375 00000 
-19 000000 .09765 62500 59 000000 .34765 62500 .99 000000 .59765 62500 .D9000000 .84765 62500 
-A 000000 .10156 25000 SA 000000 .35156 25000 9A 000000 .60156 25000 .DA00 0000 85156 25000 
-1B 000000 .10546 87500 SB 000000 .35546 87500 .9B 000000 .60546 87500 .DB00 0000 85546 87500 
-1C 000000 .1€937 50000 SC 000000 .35937 50000 9C 000000 .60937 50000 .DC00 0000 85937 50000 
-ID 000000 .11328 12500 SD 000000 .36328 12500 9D 000000 .61328 12500 .DD00 00 00 86328 12500 
IE 000000 .11718 75000 SE 000000 .36718 75000 9E 000000 .61718 75000 .DE00 0000 .86718 75000 
-IF 000000 .12109 37500 SF 000000 .37109 37500 .9F 000000 .62109 37500 .DF00 0000 87109 37500 
20 000000 .12500 00000 60 000000 # .37500 00000 .A0 000000 .62500 00000 .£0 00 00 00 .87500 00000. 
21 000000 .12890 62500 61 000000 .37890 62500 .Al 000000 .62890 62500 .E1 00 00 00 .87890 62500 
.22 000000 .13281 25000 62 000000 .38281 25000 .A2 000000 .63281 25000 .£2 000000 88281 25000 
23 000000 .13671 87500 63 000000 .38671 87500 .A3 000000 .63671 87500 .£3 000000 .88671 87500 
.24 000000 .14062 50000 64 000000 .39062 50000 .A4 000000 64062 50000 .£4 000000 89062 50000 
25 000000 .14453 12500 65 000000 .39453 12500 .AS 0000 00 .64453 12500 .ES 00 00°00 .89453 12500 
.26 000000 .14843 75000 .66 000000 .39843 75000 .A6 000000 .64843 75000 £6 00 00 00 .89843 75000 
.27 000000 .15234 37500 67 000000 .40234 37500 .A7 000000 .65234 37500 .E7 000000 .90234 37500 
.28 000000 .15625 00000 68 000000 .40625 00000 .A8 000000 .65625 00000 £8 00 00 00 .90625 00000 
.29 000000 .16015 62500 69 000000 .41015 62500 .A9 000000 .66015 62500 .E9 00 0000 91015 62500 
2A 000000 .16406 25000 6A 000000 .41406 25000 .AA 000000 .66406 25000 .EA00 0000 .91406 25000 
2B 000000 ~~ .16796 87500 6B 000000 .41796 87500 .AB 000000 .66796 87500 .EB00 0000 91796 87500 
2C 000000 .17187 50000 6C 000000 .42187 50000 .AC 000000 .67187 S000G .EC 00 00 00 .92187 50000 
2D 000000 .17578 12500 6D 000000 .42578 12500 .AD 000000 .67578 12500 .ED00 00 00 .92578 12500 
.2E 000000 .17968 75000 6E 000000 £42968 75000 .AE 000000 67968 75000 EE 0000 00 .92968 75000 
.2F 000000 .13359 37500 6F 000000 .43359 37500 .AF 000000 .68359 37500 .EF 00 0000 .93359 37500 
30 000000 .18750 00000 .70 000000 .43750 00000 .BO 000000 £.68750 00000 FO 0000 00 .93750 00000 
31 000000 .19140 62500 .71 000000 .44140 62500 .Bl 000000 .69140 62500 Fl 000000 .94140 62500 
32 000000 .19531 25000 .72 000000 44531 25000 .B2 000000 69531 25000 .F2 000000 .94531 25000 
33 000000 .19921 87500 .73 000000 .44921 87500 .B3 000000 .69921 87500 .F3 00 00 00 .94921 87500 
34 000000 .20312 50000 .74 000000 .45312 50000 .B4 000000 .70312 $0000 .F4 00 00 00 .95312 50000 
35 000000 .20703 12500 .75 000000 .45703 12500 .BS 000000 .70703 12500 .F5 00 00 00 .95703 12500 
36 000000 .21093 75000 .76 000000 .46093 75000 .B6 000000 .71093 75000 .F6 00 0000 .96093 75000 
37 000000 .21484 37500 .77 000000 .46484 37500 .B7 000000 .71484 37500 .F7 00 00 00 .96484 37500 
38 000000 .21875 00000 .78 000000 .46875 00000 .B8 000000 .71875 00000 .F8 00 00 00 .96875 00000 
39 000000 .22265 62500 .79 000000 .47265 62500 .B9 000000 .72265 62500 .F9 000000 .97265 62500 
3A 000000 .22656 25000 .7A 000000 .47656 25000 .BA 000000 .72656 25000 .FA00 00 00 97656 25000 
3B 000000 .23046 87500 .7B 000000 .48046 87500 .BB 000000 .73046 87500 .FB00 0000 98046 87500 
3C 000000 .23437 50000 .7C 000000 .48437 50000 .BC 000000 .73437 50000 .FC 00 00 00 98437 50000 
3D 000000 .23828 12500 .7D 000000 .48828 12500 .BD 000090 .73828 12500 .FD00 00 00 .98828 12500 
3E 000000 .24218 75000 .7E 000000 .49218 75000 .BE 000000 .74218 75000 .FE 00 00 00 .99218 75000 
.3F 000000 .24609 37500 .7F 000000 .49609 37500 .BF 000000 .74609 37500 .FF 000000 .99609 37500 
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Table K-6, Hexadecimal-Decimal Fraction Conversion Table (Continued) 


Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal 

.00 00 0000 .00000 00000 0040 0000  .00097 65625 .0080 0000 .00195 31250 .00 CO 0000  .00292 96875 
.00 61 0000 .00001 52587 .0041 0000  .00099 18212 .0081 0000 .00196 83837 .00 C1 0000  .00294 49462 
.00 02 0000 .00003 05175 .0042 0000 .00100 70800 .00 82 0000 .00198 36425 .00 C2 0000 .00296 02050 
.00 03 0000 .00004 57763 .0043 0000 .00102 23388 .00 83 0000 .00199 89013 .00 C3 0000  .00297 54638 
.00 04 0000 .00006 10351 .0044 0000 .00103 75976 .0084 0000 .00201 41601 .00 C4 0000  .00299 07226 
.00 05 0000 .00007 62939 .0045 0000 .00105 28564 .00 85 0000 .00202 94189 .00 CS 0000 .00300 59814 
.00 06 0000 .00009 15527 .00 46 0000 .00106 81152 .00 86 0000 .00204 46777 .00 C6 0000  .00302 12402 
.00 07 0000 .00010 68115 .0047 0000 .00108 33740 .00 87 0000 .00205 99365 .00C7 0000 .00303 64990 
.00 08 0000 .00012 20703 .0048 0000 .00109 86328 .00 88 0000 .00207 51953 .00C8 0000 .00305 17578 
.00 09 0000 .00013 73291 .0049 0000 .00111 38916 .00 89 0000 .00209 04541 .00 C9 0000 .00306 70166 
.00 0A 0000 .00015 25878 .00 4A 0000 .00112 91503 .00 8A 0000 .00210 57128 .00 CA 0000 .00308 22753 
.00 0B 0000 .00016 78466 .004B 0000 .00114 44091 .008B 0000 .00212 09716 .00 CB 0000 .00309 75341 
.00 OC 0000 .00018 31054 .004C 0000 .00115 96679 .008C 0000 .00213 62304 .00 CC 0000 .00311 27929 
.00 OD 0000 .00019 83642 .004f 0000 .00117 49267 .00 8D 0000  .00215 14892 .00 CD 0000 .00312 80517 
.00 OE 0000 .00021 36230 .004E 0000 .00119 01855 .00 8E 0000 .00216 67480 .00 CE 0000 .00314 33105 
.00 OF 0000 .00022 88818 .004F 0000 .00120 54443 .00 8F 0000 .00218 20068 .00 CF 0000 .00315 85693 
.00 10 0000 .00024 41406 .0050 0000 .00122 07031 .0090 0000 .00219 72656 .00 DO 0000 .00317 38281 
.00 11 0000 .00025 93994 .0051 0000 .00123 59619 .0091 0000 .00221 25244 .00 D1 0000 .00318 90869 
00 12 0000 .00027 46582 .0052 0000 .00125 12207 .0092 0000  .00222 77832 .00 D2 0000 .00320 43457 
.00 13 0000 .00028 99169 .00 53 0000 .00126 64794 .0093 0000 .00224 30419 .00 D3 0000 .00321 96044 
00 14 0000 .00030 51757 .00 54 0000 .00128 17382 .00 94 0000 .00225 83007 .00 D4 0000 .00323 48632 
.00 15 0000 .00032 04345 .0055 0000 .00129 69970 .0095 0000 .00227 35595 .00 DS 0000 .00325 01220 
.00 16 0000 .00033 56933 .0056 0000 .00131 22558 .0096 0000 .00228 88183 .00 D6 0000 .00326 53808 
0017 0000 .00035 09521 .0057 0000 .00132 75146 .0097 0000 .00230 40771 .00 D7 0000 .00328 06396 
.00 18 0000 .00036 62109 .00 58 0000 .00134 27734 .0098 0000 .00231.93359 .00 D8 0000 .00329 58984 
.00 19 0000 .00038 14697 .0059 0000 .00135 80322 .0099 0000 .00233 45947 .00 D9 0000 .00331 11572 
.00 1A 0000 ,.00039 67285 .00 SA 0000 .00137 32910 009A 0000 .00234 98535 .00 DA 0000 .00332 64160 
.00 1B 0000 .00041 19873 .00 5B 0000 .00138 85498 .009B 0000 .00236 51123 .00 DB 0000 .00334 16748 
00 1C 0000 .00042 72460 .005C 0000 .00140 38085 .009C 0000 .00238 03710 .00 DC 0000 .00335 69335 
.00 1D 0000 .00044 25048 .005D 0000 .00141 90673 .009D 0000 .00239 56298 .00 DD 0000 .00337 21923 
.00 1E 0000 .00045 77636 .00 SE 0000 .00143 43261 .009E 0000 .00241 08886 .00 DE 0000 .00338 74511 
00 1F 0000 .00047 30224 .00 SF 0000 .00144 95849 .009F 0000 .00242 61474 .00 DF 0000 .00340 27099 
.00 20 0000  .00048 82812 .0060 0000 .00146 48437 .00 AO 0000 .00244 14062 .00 EO 0000 .00341 79687 
.00 21 0000 .00050 35400 .0061 0000 .00148 01025 00 Al 0000 .00245 66650 .00 El 0000  .00343 32275 
.00 22 0000 .00051 87988 .0062 0000  .00149 53613 .00 A2 0000 .00247 19238 .00 E2 0000 .00344 84863 
.00 23 0000 .00053 40576 .0063 0000 .00151 06201 .00 A3 0000 .00248 71826 .00 E3 0000  .00346 37451 
.00 24 0000 .00054 93164 .0064 0000 .00152 58789 .00 A4 0000 .00250 24414 .00 E4 0000 .00347 90039 
.00 25 0000 .00056 45751 .0065 0000 .00154 11376 .00 AS 0000 .00251 77001 .00 ES 0000 .00349 42626 
.00 26 0000 .00057 98339 .0066 0000  .00155 63964 .00 A6 0000 .00253 29589 .00 E6 0000  .00350 95214 
.00 27 0000 .00059 50927 .0067 0000 .00157 16552 .00 A7 0000 .00254 82177 .00 E7 0000  .00352 47802 
.00 28 0000 .00061 03515 .0068 0000 .00158 69140 .00 A8 0000 .00256 34765 .00 E8 0000 .00354 00390 
.00 29 0000 .00062 56103 .0069 0000  .00160 21728 .00 A9 0000 .00257 87353 .00 E9 0000  .00355 52978 
.00 2A 0000 .00064 08691 .006A 0000 .00161 74316 .00 AA 0000 .00259 39941 .00 EA 0000 .00357 05566 
.00 2B 0000 .00065 61279 .006B 0000 .00163 26904 .00 AB 0000 .00260 92529 .00 EB 0000 .06358 58154 
00 2C 0000 .00067 13867 .006C 0000 .00164 79492 .00 AC 0000 .00262 45117 .00 EC 0000 .00360 10742 
.00 2D 0000 .00068 66455 .006D 0000 .00166 32080 .00 AD 0000 .00263 97705 .00 ED 0000 .0036i 63330 
.00 2E 0000 .00070 19042 .006E 0000 .00167 84667 .00 AE 0000 .00265 50292 .00 EE 0000 .00363 15917 
.00 2F 0000 .00071 71630 .006F 0000  .00169 37255 .00 AF 0000 .00267 02880 .00 EF 0000 .00364 68505 
.00 30 0000 .00073 24218 .00 70 0000 .00170 89843 .00 BO 0000 .00268 55468 .00 FO 0000 .00366 21093 
.00 31 0000 .00074 76806 .0071 0000 .00172 42421 .00 B1 0000 .00270 08056 .00 Fl 0000 .00367 73681 
.00 32 0000 .00076 29394 .0072 0000 .00173 95019 .00 B2 0000 .00271 60644 .00 F2 0000  .00369 26269 
.00 33 0000 .00077 81982 .00 73 0000 .00175 47607 .00 B3 0000 .00273 13232 .00 F3 0000 .00370 78857 
.00 34 0000 .00079 34570 .0074 0000 .00177 00195 .00 B4 0000 .00274 65820 .00 F4 0000  .00372 31445 
.00 35 0000 .00080 87158 .0075 0000 .00178 52783 .00 BS 0000 .00276 18408 .00 FS 0000 .00373 84033 
.00 36 0000 .00082 39746 .0076 0000 .00180 05371 .00 B6 0000 .00277 70996 .00 Fé 0000 .00375 36621 
.00 37 0000 .00083 92333 .0077 0000 .00181 57958 .00 B7 0000 .00279 23583 .00 F7 0000  .00376 89208 
00 38 0000  .00085 44921 .0078 0000  .00183 10546 .00 B8 0000  .00280 76171 .00 F8 0000  .00378 41796 
.00 39 0000 .00086 97509 .0079 0000 .00184 63134 .00 B9 0000  .00282 28759 .00 F9 0000 .00379 94384 
.00 3A 0000 .00088 50097 .007A 0000 .00186 15722 .00 BA 0000 .00283 81347 .00 FA 0000 .00381 46972 
.00 38 0000 .00090 02685 .00 7B 0000 .00187 68310 .00 BB 0000 .00285 33935 .00 FB 0000 .00382 99560 
00 3C 0000 .00091 55273 .007C 0000 .00189 20898 .00 BC 0000 .00286 86523 .00 FC 0000 .00384 52148 
00 3D 0000 .00093 07861 .00 7D 0000 .00190 73486 .00 BD 0000 .00288 39111 .00 FD 0000 .00386 04736 
00 3E 0000 .00094 60449 .007E 0000 .00192 26074 .00 BE 0000 .00289 91699 .00 FE 0000 .00387 57324 
.00 3F 00 00 .00096 13037 .00 7F 00 00 -00193 78662 .00 BF 00 00 .00291 44287 00 FF 00 00 .00389 09912 
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Table K-6. Hexadecimal-Decimal Fraction Conversion Table (Continued) 


Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal 

.00 0000 00 .00000 00000 .00 0040 00 .00000 38146 .00 0080 00 .00000 76293 .0000C0 00 .00001 14440 
.00 00 01 00 00000 00596 .00 0041 00 .00000 38743 .00 00 81 00  .00000 76889 .00 00 C1 00 .00001 15036 
.00 00 02 00 .00000 01192 .00 0042 00. .00000 39339 .00 0082 00 .00000 77486 .00 00 C200 .00001 15633 
.00 00 03 00 .00000 01788 .00 0043 00 .00000 39935 .00 00 83 00  .00000 78082 .00 00 C3 00 .00001 16229 
00 00 04 00 .00000 02384 .00 0044 00 .00000 40531 .00 00 84 00 .00000 78678 .00 00 C4 00 .00001 16825 
0000 05 00 .00000 02980 .00 0045 00 .00000 41127 .00 0085 00 .00000 79274 .00 00 CS 00 .00001 17421 
.00 00 06 00 .00000 03576 .00 0046 00 .00000 41723 .00 00 86 00 .00000 79870 .00 00 C6 00 .00001 18017 
.00 00 07 00 .00000 04172 .00 0047 00 .00000 42319 .00 0087 00 .00000 80466 .00 00 C7 00 .00001 18613 
.00 00 08 00 .00000 04768 .000048 00 .00000 42915 .00 0088 00 .00000 81062 .0000C8 00 .0000i 19209 
.00 0009 00 ~.00000 05364 000049 00 .00000 43511 .00 0089 00  .00000 81658 .00 00 C9 00 00001 19805 
.00 00 0A 00 .00000 05960 .00004A 00 .00000 44107 0000 8A 00 .00000 82254 0000 CA00 .00001 20401 
.00 00 0B 00 .00000 06556 .00004B 00 .00000 44703 .00 00 8B 00 .00000 82850 .00 00 CB 00 .00001 20997 
.00 00 0C 00 .00000 07152 .000.4C 00 .00000 45299 .00 00 8C 00 .00000 83446 .0000 CC 60 .00001 21593 
.00 00 OD 00 .00000 07748 .00004D 00 .00000 45895 .00 00 8D 00 .00000 84042 00 00 CD00 .00001 22189 
.00 00 OE 00 .00000 08344 0000 4E 00 .00000 46491 00 00 8E 00 .00000 84638 00 00 CE 00 .00001 22785 
.00 00 OF 00 .0000C 08940 .00004F 00 .00000 47087 .00 00 8F 00 .00000 85234 00 0C CF00 00001 23381 
00 00 10 00 .00000 09536 .00 0050 00 .00000 47683 .000090 00 .00000 85830 .00 00 D000 .00001 23977 
00 00 11 00 .00000 10132 .00 0051 00 .00000 48279 .00 0091 00 .00000 86426 .00 00 DI 00 .00001 24573 
00 00 12 00 .00000 10728 000052 00 .00000 48875 .00 0092 00  .00000 87022 .00 00 D200 .00001 25169 
00 00 13 00 .00000 11324 000053 00 .00000 49471 000093 00 .00000 87618 .00 00 D300 .00001 25765 
00 00 14 00 .00000 11920 .00 0054 00 .00000 50067 000094 OU .00000 88214 .00 00 D400 .00001 26361 
00 00 15 00 .00000 12516 .00 0055 00 .00000 50663 .000095 00 .00000 88810 .00 00 DS 00 .00001 26957 
00 00 16 00 .00000 13113 .00 0056 00 .00000 51259 .000096 00  .00000 89406 .00 00 D600 .00001 27553 
00 00 17 00 .00000 13709 .00 0057 00 .00000 51856 .000097 00 .00000 90003 .00 00 D700 = .00001 28149 
0000 18 00 .00000 14305 000058 00 .00000 52452 .00 0098 00  .00000 90599 .00 00 D800 .00001 28746 
00 00 19 00 .00000 14901 .00 0059 00 .00000 53048 .000099 00  ~.00000 91195 .00 00 D900 00001 29342 
.00 00 1A 00 .00000 15497 .00 005A 00 .00000 53644 .0000 9A 00 .00000 91791 .00 00 DADO .00001 29938 
00 00 1B 00 .00000 16093 .00 00 5B 00 .00000 54240 .00 00 9B 00 .00000 92387 .00 00 DBO0O .00001 30534 
00 00 1C 00 .00000 16689 00 0C SC 00 .00000 54836 .00009C 06 00000 92983 .00 00 DCON .00001 31130 
0000 1D 00 .00000 17285 0000 5D 00 .00000 55432 .0000 9D 00 .00000 93579 .00 00 DNOO .00001 31726 
00 00 1E 00 .00000 17881 .00 00 SE 00 .00000 56028 .00 00 9E 00 .00000 94175 .00 00 DEOO 00001 32322 
00 00 IF 00 .00000 18477 .00 00 SF 00 .00000 56624 .00009F 00 .00000 94771 .00 00 DFOUV .00001 32918 
00 00 20 00 .00000 19073 .00 0060 00 .00000 57220 .00 00 AO 00 .00000 95367 .00 00 E000 .00001 33514 
00 00 21 00 .00000 19669 .00 0061 00  .00000 57816 .00 00 Al 00 .00000 95963 .00 00 E100 .00001 34110 
00 00 22 00 .00000 20265 .00 0062 00  .00000 58412 .00 00 A2 00 .00000 96559 .00 00 E200 .00001 34706 
00 00 23 00 .00000 20861 .00 0063 00 .00000 59008 .00 00 A3 00 .00000 97155 .00 00 E300 00001 35302 
00 00 24 00 .00000 21457 .00 00 64 00 .00000 59604 .00 00 A4 00 .00000 97751 .00 00 E400 .00001 35898 
00 00 25 00 00000 22053 .00 0065 00 .00000 60200 .00 00 AS 00 .00000 98347 00 00 ES 00 .00001 36494 
00 00 26 00 .00000 22649 000066 00 .00000 60796 .00 00 A6 00 .00000 98943 .00 00 E600 .00001 37090 
00 00 27 00 .00000 23245 000067 00 .00000 61392 .00 00 A7 00 .00000 99539 .00 00 E700 .00001 37686 
00 00 28 00 .00000 23841 .00 0068 00 .00000 61988 .00 00 A8 00 .00001 00135 .00 00 E800 .00001 38282 
00 00 29 00 .00000 24437 000069 00  .00000 62584 .00 00 AI 00 .00001 00731 .00 00 E900 .00U01 38878 
00 00 2A 00 .00000 25033 .00 006A 00 .00000 63180 .0000 AA 00 .00001 01327 00 CO EA00 .00001 39474 
00 00 2B 00 .00000 25629 .00 00 6B 00 .00000 63776 .00 00 AB 00 .00001 01923 .00 00 EB00 .00001 40070 
00 00 2C 00 .00000 26226 .00006C 00 .00000 64373 .00 00 AC 00 .00001 02519 00 00 EC 00 0000! 40666 
0000 2D 00 00000 26822 .00006D 00 .00000 64969 .0000 AD 00 .00001 03116 .00 00 EDOO .00001 41263 
00 00 2E 00 .00000 27418 .00 00 6E 00 .00000 65565 .00 00 AE 00 .00001 03712 .00 00 EE00 000i! 41859 
00 00 2F 00 .00000 28014 .00 00 6F 00 .00000 61661  .00 00 AF OU 00001 04308 00 00 EF 00 .0N001 42455 
00 00 30 00 .00000 28610 000070 00  .00000 66757 .00 00 BO 00 .00001 04904 .00 00 FO V0 .00001 43051 
00 00 31 00 .00000 29206 .000071 00  .00000 67353 .00 00 B1 00 .00001 05500 .00 00 F100 00001 43647 
00 00 32 00 .00000 29802 000072 00  .00000 67949 .00 00 B2 00 00001 06096 .00 00 F200 .00001 44243 
-00 00 33 00 .00000 30398 000073 00  .00000 68545 .00 00 B3 00 .00001 06692 .00 00 F300 .00001 44839 
00 00 34 00 .00000 30994 .0000 74 00  .00000 69141 .00 00 B4 00 .00001 07228 .00 00 F400 .00001 45435 
00 00 35 00 .00000 31590 000075 00 .00000 69737 .00 00 BS 00 .00001 07884 .00 00 FS 00 .00001 46031 
00 00 36 00 .00000 32186 .000076 00  .00000 70333 .00 00 B6 00 .00001 08480 .00 00 F600 .00001 46627 
© 00 37 00 .00000 32782 .000077 00 .00000 70929 00 00 B7 00 00001 09076 .00 00 F700 .00001 47223 
.00 00 38 00 .00000 33378 000078 00  .00000 71525 .00 00 B8 00 .00001 09672 .00 00 F800 00001 47819 
00 00 39 00 .00000 33974 .000079 00 .00000 75121 .00 00 B9 00  .00001 10268 .00 00 F900 .00001 48415 
00 003A 00 .00000 34570 .00 007A 00 .00000 72717 0000 BA 00 .00001 10864 .00 00 FA0O .00001 49011 
00 00 3B 00 .00000 35166 .00007B 00 .00000 73313  .00 00 BB 00 .00001 11460 .00 00 FBO0O .00001 49607 
90 00 3C 00 .00000 35762 .00007C 00  .00000 73909 .0000 BC 00 .00001 12056 .00 00 FC00 .00001 50203 
00 00 3D 00 .00000 36358 .00007D 00 .00000 74505 .00 00 BD 00 .00001 12652 .00 00 EDO0O .00001 50799 
00 00 3E 00 00000 36954 .00 00 7E 00 .00000 75101 .0000 BE 00 .00001 13248 .00 00 FE00 .00001 51395 
00 00 3F 00 00000 37550 .00007F 00  .00000 75697 .00 00 BF 00 .00001 13844 .00 00 FF00 .00001 51991 
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Table K-6, Hexadecimal-Decimal Fraction Conversion Table (Continued) 


Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal Hexadecimal Decimal 
.00 00 00 00 .00000 00000 .000000 40 .00000 00149 000000 80 -00000 00298 .00 00 00 CO .00000 00447 
.00 00 00 O1 -00000 00002 .00 0000 41 -00000 00151 .00 0000 81 -00000 00300 .00 00 00 C1 .00000 00449 
.00 00 00 02 -00000 00004 .00 0000 42 -00000 00153 .00 00 00 82 -00000 00302 .00 00 00 C2 .00000 00451 
.00 00 00 03 -00000 00006 .00 00 00 43 -00000 00155 .00 00 00 83 -00000 0030S .00 00 00 C3 .00000 00454 
.00 00 00 04 -00000 00009 00 0000 44 -00000 00158 .00 00 00 84 -00000 00307 .00 00 00 C4 .00000 00456 
.00 00 00 05 -00000 00011 .000000 45 -00000 00160 .00 00 00 8&5 -00000 00309 .00 00 00 CS .00000 00458 
.00 00 00 06 .00000 00013 .00 0000 46 -00000 00162 .00 00 00 86 -00000 00311 .00 00 00 C6 .00000 00461 
.00 00 00 07 -00000 00016 .00 00 00 47 -00000 00165 .00 00 00 87 .00000 00314 .00 00 00 C7 .00000 00463 
.00 00 00 08 -00000 00018 .00 00 00 48 -00000 00167 .00 00 00 88 -00000 00316 .00 00 00 C8 .00000 00465 
.00 00 00 09 -00000 00020 .00 0000 49 .00000 00169 .00 0000 89 -00000 00318  .00 00 00 C9 .00000 00467 
00 00 00 OA 00000 00023 .00 0000 4A .00000 00172 .000000 8A .00000 0032r .00 00 00 CA .00000 00470 
.00 00 00 OB .00000 00025 .00 0000 4B .00000 00174 .00 0000 8B .00000 00323 .00 00 00 CB .00000 00472 
00 00 00 OC .00000 00027 .00 0000 4C .00000 00176 .000000 8C .00000 00325 .00 00 00 CC .00000 00474 
.00 0000 OD .00000 00030 .00 0000 4D .00000 00179 .00 0000 8D .00000 00328 .00 00 00 CD .00000 00477 
00 00 00 OE .00000 00032 .00 0000 4E .00000 00181 .00 0000 8E 00000 00330 .00 00 00 CE .00000 00479 
0000 00 OF  .00000 00034 .00 0000 4F .00000 00183 .00 0000 8F .00000 00332 .00 00 00 CF .00000 00481 
0000 00 10 .00000 00037 .000000 50 .00000 00186 .000000 90 .00000 00335 .00 00 00 DO .00000 00484 
.00 00 00 11 -00000 00039 .00 0000 51 -00000 00188 .00 0000 91 -00000 00337 .00 00 00 D1 .00000 00486 
00 00 00 12 -00000 00041 .00 00 00 52 00000 00190 .00 0000 92 -00000 00339 .00 00 00 D2 .00000 00488 
.00 00 00 13 -00000 00044 .00 00 00 53 -00000 00193 .00 0000 93 .00000 00342 .00 00 00 D3 .00000 00491 
.00 00 00 14 -00000 00046 000000 54 -00000 00195 .00 00 00 94 -00000 00344 .00 00 00 D4 .00000 00493 
.00 00 00 15 -00000 00048 .00 0000 55 -00000 00197 .00 00 00 95 -00000 00346 .00 00 00 DS .00000 00495 
.00 00 00 16 -00000 00051 .00 00 00 56 -00000 00200 .00 00 00 96 -00000 00349 .00 00 00 D6 .00000 00498 
00 00 00 17 -00000 00053 .00 00 00 57 -00000 00202 .00 00 00 97 .00000 00351 .00 00 00 D7 .00000 00500 
00 00 00 18 -00000 00055 .00 00 00 58 .00000 00204 .00 00 00 98 .00000 00353 .00 00 00 D& .00000 00502 
00 00 00 19 .00000 00058 .00 0000 59 -00000 00207 .00 00 00 99 -00000 00356 .00 00 00 D9 .00000 00505 
00 00 00 1A .00000 00060 .00 0000 SA .00000 00209 .00 0000 9A .00000 00358  .00 00 00 DA .00000 00507 
000000 1B .00000 00062 .00 0000 SB .00000 00211 .00 0000 9B .00000 00360 .00 00 00 DB .00000 00509 
0000 00 1C .00000 00065 .00 0000 SC .00000 00214 .00 0000 9C .00000 00363 .00 00 00 DC .00000 00512 
0000 00 1D .00000 00067 .000000 SD .00000 00216 .00 0000 9D .00000 00365 .00 00 00 DD .00000 00514 
.00 0000 1E .00000 00069 .000000 SE .00000 00218 .00 0000 9E .00000 00367 .00 00 00 DE .00000 00516 
.00 0000 1F .00000 00072 .60 0000 SF .00000 00221 .00 0000 9F .00000 00370 .00 00 00 DF .00000 00519 
.00 0000 20 .00000 00074 .00 0000 60 .00000 00223 .00 0000 AO .00000 00372 .00 00 00 EO .00000 00521 
.00 00 00 21 -00000 00076 .00 0000 61 .00000 00225 .00 0000 Ai .00000 00374 .00 00 00 El .00000 00523 
.00 00 00 22 -00000 00079 .00 00 00 62 .00000 00228 .00 0000 A2 .00000 00377 .00 00 00 E2 .00000 00526 
.00 00 00 23 -00000 00081 .00 0000 63 .00000 00230 .00 0000 A3 .00000 00379 .00 00 00 E3 .00000 00528 
.00 00 00 24 -00000 00083 .00 0000 64 .00000 00232 .00 0000 A4 .00000 00381 .00 00 00 EA .00000 00530 
.00 00 00 25 -00000 00086 .00 00 00 65 .00000 00235 .00 0000 AS .00000 00384 .00 00 00 ES .00000 00533 
.00 00 00 26 -00000 00088 .00 0000 66 .00000 00237 .0000 00 A6 .00000 00386 .00 00 00 E6 .00000 00535 
.00 00 00 27 -00000 00090 .00 00 00 67 .00000 00239 .00 0000 A7 .00000 00388  .00 00 00 E7 .00000 00537 
.00 00 00 28 -00000 00093 .00 00 00 68 .00000 00242 .00 0000 A8& .00000 00391 .00 00 00 E8 .00000 00540 
.00 00 00 29 .00000 00095 .00 0000 69 .00000 00244 .00 0000 A9 .00000 00393 .00 00 00 E9 .00000 00542 
.00 0000 2A .00000 00097 .00 0000 6A  .00000 00246 .00 0000 AA _  .00000 00395 .00 00 00 EA .00000 00544 
.00 00 00 2B .00000 00100 .00 0000 6B .00000 00249 .00 0000 AB .00000 00398 .00 00 00 EB .00000 00547 
.00 00 00 2C .00000 00102 .00 0000 6C .00000 00251 .00 0000 AC .00000 00400 .00 00 00 EC. .00000 00549 
.00 00 00 2D .00000 00104 .000000 6D .00000 00253 .00 0000 AD .00000 00402 .00 00 00 ED .00000 00551 
.00 00 00 2E .00000 00107 .000000 6E .00000 00256 .000000 AE .00000 00405 .00 00 00 EE .00000 00554 
.00 0000 2F .00000 00109 .00 0000 6F .00000 00258 .00 0000 AF .00000 00407 .00 00 00 EF .00000 00556 
.00 00 00 30 .00000 00111 .00 0000 70  .00000 00260 .00 0000 BO .00000 00409 .00 00 00 FO .00000 00558 
.00 00 00 31 .00000 00114 .00 0000 71 .00000 00263 .00 0000 Bl .00000 00412 .00 00 00 Fi .00000 00561 
.00 00 00 32 -00000 00116 .00 0000 72 .00000 00265 .00 0000 B2 .00000 00414 .00 00 00 F2 .00000 00563 
.00 00 00 33 -00000 00118 .00 00 00 73 .00000 00267 .00 00 00 B3 .00000 00416 .00 00 00 F3 .00000 00565 
.00 00 00 34 -00000 00121 .00 0000 74 .00000 00270 .00 00 00 B4 .00000 00419 .00 00 00 F4 .00000 00568 
.00 00 00 35 .00000 00123 .00 00 00 75 .00000 00272 .00 00 00 BS  .00000 00421 .00 00 00 F5 .00000 00570 
.00 00 00 36 .00000 00125 .00 00 00 76 .00000 00274 .00 00 00 B6 .00000 00423 .00 00 00 Fé .00000 00572 
.00 00 00 37 -00000 00128 .00 00 00 77 .00000 00277. .00 00 00 B7 .00000 00426 .00 00 00 F7 .00000 00575 
.00 00 00 38 .00000 00130 .00 00 00 78 .00000 00279 .00 0000 BS  .00000 00428 .00 00 00 F8 .00000 00577 
.00 00 00 39 .00000 00132 .00 0000 79  .00000 00281 .00 0000 B9  .00000 00430 .00 00 00 F9 .00000 00579 
.00 0000 3A .00000 00135 .000000 7A .00000 00284 .000000 BA .00000 00433 .00 00 00 FA .00000 00582 
.00 00 00 3B .00000 00137 .000000 7B .00000 00286 .00 0000 BB .00000 00435 .00 00 00 FB .00000 00584 
00 00 00 3C .00000 00139 .000000 7C .00000 00288 .0000 00 BC .00000 00437 .00 00 00 FC .00000 00586 
.00 00 00 3D .00000 00142 .000000 7D .00000 00291 .00 0000 BD .00000 00440 .00 00 00 FD .00000 00589 
.00 0000 3E .00000 00144 .000000 7E .00000 00293 .000000 BE .00000 00442 .00 00 00 FE .00000 00591 
.00 0000 3F .00000 00146 .00 0000 7F .00000 00295 .00 0000 BF .00000 00444 .00 00 00 FF .00000 00593 
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Table K-7. 


Constant 
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Common Mathematical Constants 


Decimal Value 


3.14159 26535 
0.31830 98861 
1.77245 38509 
1.14472 98858 
2.71828 18284 
0.36787 994411 
1.64872 12707 
0.43429 44819 
1.44269 50408 
0.57721 56649 


—0.54953 93129 


1.41421 35623 
0.69314 71805 
0.30102 99956 
3.16227 76601 
2.30258 40929 


89793 
83790 
05516 
49400 
59045 
71442 
00128 
03252 
88963 
01533 
81645 
73095 
59945 
63981 
68379 
94046 


Hexadecimal Value 


3.243F 6A89 
0.517C C1B7 


L.CSBF 891 
1.250D 048F 
2.B7E1 5163 
0.5E2D  58D9 
1.4612 98E2 
0.6F2D CSS 
1.7154 7653 


0.93C4 67E4 
-0.8CAE 9BC1 
1.6A09 E668 
0.B172 17F8 
0.4D10 4D42 
3.298B 075C 
2.4D76 3777 
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TRIUMPH-ADLER Aktiengeselischaft 
fur BUro- und Informationstechnik 
Further StraBe 212 - D 8500 Nurnberg 
Tel. (0911) 322-0 - Telex 6-23 295 


Alle Rechte, sowie Anderungen und Verbesserungen behalten wir uns 
ohne Ankiindigung vor. 


All rights reserved, including the right to make alterations and improve- 
ments without previous notice. 


Nous nous réservons tous les droits ainsi que |'application de toute 
modification ou amélioration, sans avis préliminaire. 


Nos reservamos todos los derechos asi como hacer modificaciones y 
mejoras sin previo aviso. 


Ciriserviamo tutti i diritti, come pure modifiche e correzionisenzapre - 
avviso. 


